ddname

Positional parameter that specifies the data set to allocate

This parameter is the functional equivalent of the ddname field of the JCL DD statement. This parameter is required.

AFFINITY

(subsystem name)

AFF

None

In a Multi-Access Spool (MAS) environment, specifies the ID of the CA Spool subsystem that will eventually process this file.

BLKSIZE

(block size)

BLK, BLKSZ

None

The equivalent of the DCB=(BLKSIZE= ) parameter in the DD JCL statement

Specifies the physical block size

CLASS
(output class)

CLA

Installation- specific

Specifies the output class of the file to create. Enter a single alphanumeric character.

COPIES
(copy count)

COP

COPIES (1)

Specifies the number of copies to print. Enter 1-3 decimal digits in the range 1-255.

DELETE
(YES | NO)

DEL

DELETE(NO)

Specifies whether an output file will be deleted if it is empty. Parameters accepted are N or NO (keep file) or Y, YE, or YES (delete empty file).

DEST
(destination name)

DES

Destination name from TSO user profile

Specifies the destination name of the file to process. Enter a valid CA Spool or JES2/JES3 destination.

FCB
(form control buffer)

None

Installation -specific

Specifies the FCB to use when printing this file. Enter a 1-4 alphanumeric character FCB name.

FORM
(form number)

FOR

Installation -specific

Specifies the form number to use when printing this output file. Enter a 1-8 alphanumeric character form identification number.

FREE
(CLOSE)

FRE

Not to deallocate at close time

Specifies whether the file should be de-allocated at close time

HOLD
(YES | NO)

HOL

HOLD(NO)

Specifies whether an output file is held or scheduled for printing. Parameters accepted are N or NO (do not hold) or Y, YE, or YES (hold file).

LIKE
(ddname)

LIK

None

Specifies the Model file to use when assigning attribute values to this file. The name specified must be the name of a CA Spool file allocation created either by using this command, or by placing a DD SUBSYS= JCL statement in the logon procedure.

LRECL
(logical record length)

LRL

None

The equivalent of the DCB=(LRECL= parameter in the DD JCL statement. Specifies the logical record length

NAME
(programmer's name)

NAM

None

Specifies the programmer's name, which may help to identify this file. The number of positions available is usually determined by a system programmer. Any character may be used.

OUTDES
(output statement reference)

ODE

None

Refers to an OUTPUT JCL statement in the logon procedure

OUTLIM
(output limit)

MAX,LIM

Installation -specific

Specifies the maximum number of lines that the file being created may contain. If this number is exceeded, an abend U722 results.

OWNER
(filename)

OWN

TSO userid

Specifies the name of the file to be processed. Enter 1-8 alphanumeric characters.

RECFM
(record format)

RFM

None

Specifies the equivalent of the DCB=(RECFM= parameter of the DD JCL statement. Parameters accepted are:

• F—Fixed length
• FA—Fixed length, ASA control character
• FM—Fixed length, MCH control character
• FBA—Fixed length, blocked, ASA control character
• FBM—Fixed length, blocked, MCH control character
• V—Variable length
• VA—Variable length, ASA control character
• VM—Variable length, MCH control character
• VBA—Variable length, blocked, ASA control character
• VBM—Variable length, blocked, MCH control character

RETAIN
(retain time)

RET

Value from printer definition

Specifies the number of hours the file should be retained after it is printed

If a value of 0 is specified, the file is purged immediately after it is printed.

If blank, the default value from the printer definition is used.

SEQNR
(file sequence number)

SEQ

None

Specifies the CA Spool-assigned file sequence number of the file to be read. The presence of this parameter is used to distinguish between an input and an output file.

SUBSYS
(subsystem name)

SUB

ESF

Specifies the CA Spool subsystem to process this allocation request

USER
(user information)

USE

None

Specifies information to pass to the interface exit routine

Enter 1-4 alphanumeric characters according to local standards.

To generate a new print file each time the allocation is opened and closed, specify the value SEPA in the USER parameter. Other values are not used by CA Spool.