z/OS V1R9.0 TSO/E Command Reference

ALLOCATE Command|||||||FILE(name) | DDNAME(name)specifies the name to be associated with the data set. It can contain up to eightcharacters. (This name corresponds to the name on the data definition (DD)statement in job control language and must match the ddname in the datacontrol block (DCB) that is associated with the data set.) For PL/I, this name isthe file name in a DECLARE statement and has the form DCL file name FILE;for example, DCL MASTER FILE. For COBOL, this name is the external nameused in the ASSIGN TO clause. For FORTRAN, this name is the data setreference number that identifies a data set and has the form FTxxFyyy, forinstance, FT06F002.If you omit this operand, the system assigns an available file name (ddname)from a data definition statement in the procedure that is invoked when you enterthe LOGON command.Do not use special ddnames unless you want to use the facilities those namesrepresent to the system.For more information about the special ddnames SYSMDUMP, SYSUDUMP,SYSCHK, SYSCKEOV, and SYSABEND see z/OS MVS JCL Reference.For more information about the special ddnames JOBCAT, JOBLIB, STEPCAT,and STEPLIB see z/OS MVS JCL Reference.OLD | SHR | MOD | NEW | SYSOUT(class)OLDindicates the data set currently exists and you require exclusive use of thedata set. The data set should be cataloged. If it is not, you must specify theVOLUME operand. OLD data sets are retained by the system when youfree them from allocation. The DATASET or DSNAME operand is required.SHRindicates the data set currently exists, but you do not require exclusive useof the data set. Others can use it concurrently. ALLOCATE assumes thedata set is cataloged if the VOLUME operand is not entered. SHR data setsare retained by the system when you free them. The DATASET orDSNAME operand is required.MODindicates you want to append data to the end of the sequential data set. Donot catalog the data set or specify VOLUME=SER when you useDISP=MOD to create a new data set. After creation, the system changesthe disposition of the data set to NEW. If the data set does not exist, a newdata set is created and the disposition is changed to NEW. MOD data setsare retained by the system when you free them. The DATASET orDSNAME operand is required.NEW(non-VSAM only, unless SMS is running) indicates the data set does notexist and it is to be created. For new partitioned data sets, you must specifythe DIR operand. If you specify a data set name, a NEW data set is keptand cataloged. If you do not specify a data set name, it is deleted when youfree it or log off.SMS will only manage data sets that were allocated with a disposition ofNEW while SMS was active.SYSOUT[(class)]indicates the data set is to be a system output data set. An optional subfieldcan be defined giving the output class of the data set. Output data is initially24 z/OS V1R9.0 TSO/E Command Reference