z/OS V1R9.0 TSO/E Command Reference

ALLOCATE Commanddirected to the job entry subsystem (JES) and can later be transcribed to afinal output device. The final output device is associated with output classby the installation. After transcription by the job entry subsystem, SYSOUTdata sets are deleted.The system generates names for SYSOUT data sets; therefore, you shouldnot specify a data set name when you allocate a SYSOUT data set. If youdo, the system ignores it.You can specify the OUTDES operand of the ALLOCATE command or thePRINTDS command to supply the name or names of the output descriptorsthat were created by the OUTPUT JCL statements in the LOGONprocedure. Specifying OUTDES eliminates the need to supply informationrelated to the printer or the type of printing to be done. For moreinformation about establishing OUTPUT JCL statements in the LOGONprocedure, see z/OS TSO/E Customization.If you do not specify an output class value, the ALLOCATE command usesthe default output class, which was determined during logon for your userID. If no default class was set for your user ID, JES assigns an output classaccording to its assignment procedures, using any referenced or defaultoutput descriptors.If you want to allocate a SYSOUT data set, the following operands are usedexclusively with SYSOUT:ALLOCATE DDNAME, SYSOUT, DEST, HOLD, NOHOLD, COPIES, BURST/NOBURST,CHARS, FLASH, MODIFY, FCB, FORMS, OUTDES, UCS, WRITER, SPIN, SEGMENTIf you do not specify OLD, SHR, MOD, NEW, or SYSOUT, a default value isassigned or a value is prompted for, depending on the other operands specified:v If the LIKE operand or any space operands (SPACE, DIR, BLOCK, BLKSIZE,AVBLOCK, TRACKS, or CYLINDERS) are specified, then the status defaultsto NEW.v If the COPIES operand is specified, then the status defaults to SYSOUT.v If the DATASET/DSNAME operand is entered without the LIKE operand orany space operands, then the status defaults to OLD.v If the LIKE operand, the DATASET/DSNAME operand, and the spaceoperands are all omitted, you are prompted to enter a status value.VOLUME(serial_list)specifies the serial number(s) of an eligible direct access volume(s) on which anew data set is to reside or on which an old data set is located. If you specifyVOLUME for an old data set, the data set must be on the specified volume(s)for allocation to take place. If you do not specify VOLUME, new data sets areallocated to any eligible direct access volume. Eligibility is determined by theUNIT information in your procedure entry in the user attribute data set (UADS).You can specify up to 255 volume serial numbers.With SMS, the VOLUME operand is not suggested. The system determines theUNIT and VOLUME from the storage class (STORCLAS operand) associatedwith the data set. If SMS does not manage the data set and you want toallocate a data set to a specific volume, explicitly specify VOLUME.DATACLAS(data_class_name)if SMS is active, specifies the name, 1 to 8 characters, of the data class for thedata set. The data set does not have to be managed by SMS.Using the DATACLAS operand to define the data class makes specifying all theattributes for a data set unnecessary. For example, the storage administratorChapter 1. TSO/E commands and subcommands 25