VM370 System Programmers Guide (Rel6)
Page313(336 of 430)
Page of GC20-1807-7 As Updated April 1, 1981 by TNL GN25-0829 DTFD! - the lile fo!: Devi£g 12.£ Qn.it§ CMS/DOS supports most operands of the DTFDI macro. Figure 37 describes the operands of the DTFDI macro and their support under eMS/DOS. An asterisk in the status column indicates that CMS/DOS support differs from DOS/VS support. r---- I Operand DEVADDR=SYSxxx IOAREA1=xxxxxxxx EOFADDR=xxxxxxxx ERROPT=xxxxxxxx IOAREA2=xxxxxxxx I OREG2= (nn) MODNAME=xxxxxxxx RDONLY=YES RECSIZE=nnn SEPASMB=YES WLRERR=xxxxxxxx IStatusl Descri ption I (SYSIPT, SYSLST, SYSPCH, or SYSRDR). System I logical unit. CMS/DOS issues an error I message if the logical unit specified on I the DTF does not match the logical unit I specified on the corresponding DLBL I command. I Name of the first I/O area. I Name of your end-of-fi Ie routine. I (IGNORE, SKIP, or name of your error I routine) v Prevents termination on errors. IIf two I/O areas are used, name of second I area. IRegister number. If omitted and two I/O I areas are used, register 2 is I General registers 2 through 12, enclosed I in parentheses. IDIMOD name for this DTF. If omitted, laCS I generates a standard name. IGenerates a read-only module. Requires a I module save area for each routine using I t he module. INumber of characters in record. Default I values: 121 (SYSLST), 81 (SYSPCH), 180 (other). IDTFDI to be assembled separately. IName of your wrong-length record routine. 1..- __ _ Fiqure 37. CMS/DOS Support of DTFDI Macro Part 3. Conversational Monitor System (CMS) 297
Apr ill, 1981 CKS/DOS does not support the ASCII, BUFOFF, READ=BACK operands of the DTFKT macro. Tape I/O to reading in the forward direction. HDRINFO, LENCHK, and operations are limited eMS/DOS creates unlabeled taoes and User-written label processing routines are handles tape labels as follows: bypasses standard labels. used, when supplied. CMS/DOS If Input tape has label Input tape has a stan dar d label Input tape has nonstandard label Tape opened for output The CMS/DOS open routine positions the tape at the first data record. The CMS/DOS open routine positions the tape at the first data record (that is, standard labels are bypassed). If user labels are detected and if a user label routine is specified (LABADDR=xxxxxxxx) in the DTF table for the file, CMS/DOS exits to the user's routines to read and process the user labels. The eMS/DOS open routine exits to the user's routine specified by the LABADDR=xxxxxxxx operand of the DTFKT macro. If no user routine is specified, the tape is positioned at the first data record. CMS/DOS treats all tapes (standard labeled tapes, nonstandard labeled tapes, and unlabeled tapes) as if they were unlabeled. If a tape with a standard or nonstandard label is opened for output, CKS/DOS writes over the label. This is also true for tape workfiles because they are opened for output first. The CKS/DOS close routine does not perform trailer label checking on input files. No trailer label processing is provided for input or output tape files. Figure 38 describes the DTFMT macro operands and their support under CMS/DOS. An asterisk (*) in the status column indicates that CMS/DOS support differs from DOS/VS support. 298 IBM VM/370 System Programmer's Guide
Page of GC20-1807-7 As Updated April 1, 1981 by TNL GN25-0829 DTFD! - the lile fo!: Devi£g 12.£ Qn.it§ CMS/DOS supports most operands of the DTFDI macro. Figure 37 describes the operands of the DTFDI macro and their support under eMS/DOS. An asterisk in the status column indicates that CMS/DOS support differs from DOS/VS support. r---- I Operand DEVADDR=SYSxxx IOAREA1=xxxxxxxx EOFADDR=xxxxxxxx ERROPT=xxxxxxxx IOAREA2=xxxxxxxx I OREG2= (nn) MODNAME=xxxxxxxx RDONLY=YES RECSIZE=nnn SEPASMB=YES WLRERR=xxxxxxxx IStatusl Descri ption I (SYSIPT, SYSLST, SYSPCH, or SYSRDR). System I logical unit. CMS/DOS issues an error I message if the logical unit specified on I the DTF does not match the logical unit I specified on the corresponding DLBL I command. I Name of the first I/O area. I Name of your end-of-fi Ie routine. I (IGNORE, SKIP, or name of your error I routine) v Prevents termination on errors. IIf two I/O areas are used, name of second I area. IRegister number. If omitted and two I/O I areas are used, register 2 is I General registers 2 through 12, enclosed I in parentheses. IDIMOD name for this DTF. If omitted, laCS I generates a standard name. IGenerates a read-only module. Requires a I module save area for each routine using I t he module. INumber of characters in record. Default I values: 121 (SYSLST), 81 (SYSPCH), 180 (other). IDTFDI to be assembled separately. IName of your wrong-length record routine. 1..- __ _ Fiqure 37. CMS/DOS Support of DTFDI Macro Part 3. Conversational Monitor System (CMS) 297
Apr ill, 1981 CKS/DOS does not support the ASCII, BUFOFF, READ=BACK operands of the DTFKT macro. Tape I/O to reading in the forward direction. HDRINFO, LENCHK, and operations are limited eMS/DOS creates unlabeled taoes and User-written label processing routines are handles tape labels as follows: bypasses standard labels. used, when supplied. CMS/DOS If Input tape has label Input tape has a stan dar d label Input tape has nonstandard label Tape opened for output The CMS/DOS open routine positions the tape at the first data record. The CMS/DOS open routine positions the tape at the first data record (that is, standard labels are bypassed). If user labels are detected and if a user label routine is specified (LABADDR=xxxxxxxx) in the DTF table for the file, CMS/DOS exits to the user's routines to read and process the user labels. The eMS/DOS open routine exits to the user's routine specified by the LABADDR=xxxxxxxx operand of the DTFKT macro. If no user routine is specified, the tape is positioned at the first data record. CMS/DOS treats all tapes (standard labeled tapes, nonstandard labeled tapes, and unlabeled tapes) as if they were unlabeled. If a tape with a standard or nonstandard label is opened for output, CKS/DOS writes over the label. This is also true for tape workfiles because they are opened for output first. The CKS/DOS close routine does not perform trailer label checking on input files. No trailer label processing is provided for input or output tape files. Figure 38 describes the DTFMT macro operands and their support under CMS/DOS. An asterisk (*) in the status column indicates that CMS/DOS support differs from DOS/VS support. 298 IBM VM/370 System Programmer's Guide
VM370 System Programmers Guide (Rel6)
Page311(334 of 430)
r-------------------------------------------------------------------------, Operand IStatusl Description 1 --------------------------------------------------------------------------; IDEVADDR=SYSxxx ISymbolic unit for reader-punch used for thisl t f file.. I 1-------------------------------------------------------------------1 I IOAREA1=xxxxxxxx * jName of the first 1------------------------------------------------------------------------ I ASOCFLE=xxxxxxxx * INot supported. 1-------------------------------------------------------------------- IBLKSIZE=nnn * 1 I CONTROL=YES CRDERR=RETRY * CTLCHR=xxx DEVICE=nnnn * EOFADDR=xxxxxxxx ERROPT=xxxxxx * FUNC=xxx * IOAREA2=xxxxxxxx * IOREG= (nn) MODE=xx * MODNAME=xxxxxxxx OUBLKSZ=nn * RDONLY=YES * RECFORM=xxxxxx RECSIZE= (nn) * ILength of one I/O area, in bytes. If 1 omitted, 80 is assumed. If CTLCHR=YES is I specified, BLKSIZE defaults to 81. ICNTRL macro used for this file. Omit CTLCHR 1 for this file. Does not apply to 2501. jRetry if punching error is detected. Applies 1 to 2520 and 2540 only. However, this I situation is never encountered under 1 CMS/DOS because hardware errors are not 1 passed to the LIOCS module. 1 (YES or ASA). Data records have control I character. YES for S/370 character set; ASA I for American National Standards Institute 1 character set. Omit CONTROL for this file. 1(2501, 2520, 2540, 3505, or 3525). If I omitted, 2540 is default. IName of your end-of-file routine. IIGNORE, SKIP, or name. Applies to 3505 and I 3525 only. INot supported. IIf two output areas are used, name of I second area. IRegister number if two I/O areas were used I and GET or PUT does not specify a work I area. Omit WORKA. 10nly MODE=E is supported. IName of the logic module that is used with 1 the DTF table to process the file. INot supported. ICauses a read-only module to be generated. 1 (FIXUNB, VARUNB, UNDEF). If omitted, FIXUNB I is default. IRegister number if RECFORM=UNDEF. Figure 35. CMS/DOS Support of DTFCD Macro (Part 1 of 2) Part 3. Conversational Monitor System (CMS) 295
r--- I Operand 1 ISEPASMB=YES 1 ISSELECT=n 1 ITYPE=xxxxxx I Sta tus I Description IDTFCD is to be assembled separately. * IIgnored. * IInput or output. 1--------------------------------------------------------------------------- IWORKA=YES I 11/0 records are processed in work areas I instead of the 110 areas. Figure 35. CMS/DOS support of DTFCD Macro (Part 2 of 2) CMS/DOS supports all of the operands of the tTFCN macro. Figure 36 describes the operands of the DTFCN macro and their support under CMS/DOS. The status column is blank because the CMS/DOS and DOS/VS support of DTFCN are the same. I Operand I IDEVADDR=SYSxxx I I I IOAREA1=xxxxxxxx I IBLKSIZE=nnn I , I I IINPSIZE=nnn I I I MODNAME=xxxxxxxx RECFORM=xxxxxx RECSIZE= (nn) TYPEFLE=xxxxxx IWORKA=YES L !Statusl Description ISymbolic unit for the console used for this I file. IName of I/O area. ILength in bytes of I/O area (for PUTR macro usage, length of output part of I/O area). I If RECFORM=UNDEF, maximum is 256. If I omitted, 80 is default. ILength in bytes for input part of I/O area I for PUTR macro usage. ILogic module name for this DTF. If omitted, I IOCS generates a standard name. I IThe logic module is generated as part of I the DTF. I (FIXUNB or UNDEF). If omitted, FIXUNB is I default. IRegister number if RECFORM=UNDEF. General I registers 2 through 12, enclosed in I parentheses. I (I NPUT, OUTPUT, or CMBND). Input processes I both input dnd output. CMBND must be I specified for PUTR macro usage. If omitted, I :NPUT is default. IGET or PUT specifies work area. Figure 36. eMS/DOS support of DTFCN macro. 296 IBM System programmer's Guide
r-------------------------------------------------------------------------, Operand IStatusl Description 1 --------------------------------------------------------------------------; IDEVADDR=SYSxxx ISymbolic unit for reader-punch used for thisl t f file.. I 1-------------------------------------------------------------------1 I IOAREA1=xxxxxxxx * jName of the first 1------------------------------------------------------------------------ I ASOCFLE=xxxxxxxx * INot supported. 1-------------------------------------------------------------------- IBLKSIZE=nnn * 1 I CONTROL=YES CRDERR=RETRY * CTLCHR=xxx DEVICE=nnnn * EOFADDR=xxxxxxxx ERROPT=xxxxxx * FUNC=xxx * IOAREA2=xxxxxxxx * IOREG= (nn) MODE=xx * MODNAME=xxxxxxxx OUBLKSZ=nn * RDONLY=YES * RECFORM=xxxxxx RECSIZE= (nn) * ILength of one I/O area, in bytes. If 1 omitted, 80 is assumed. If CTLCHR=YES is I specified, BLKSIZE defaults to 81. ICNTRL macro used for this file. Omit CTLCHR 1 for this file. Does not apply to 2501. jRetry if punching error is detected. Applies 1 to 2520 and 2540 only. However, this I situation is never encountered under 1 CMS/DOS because hardware errors are not 1 passed to the LIOCS module. 1 (YES or ASA). Data records have control I character. YES for S/370 character set; ASA I for American National Standards Institute 1 character set. Omit CONTROL for this file. 1(2501, 2520, 2540, 3505, or 3525). If I omitted, 2540 is default. IName of your end-of-file routine. IIGNORE, SKIP, or name. Applies to 3505 and I 3525 only. INot supported. IIf two output areas are used, name of I second area. IRegister number if two I/O areas were used I and GET or PUT does not specify a work I area. Omit WORKA. 10nly MODE=E is supported. IName of the logic module that is used with 1 the DTF table to process the file. INot supported. ICauses a read-only module to be generated. 1 (FIXUNB, VARUNB, UNDEF). If omitted, FIXUNB I is default. IRegister number if RECFORM=UNDEF. Figure 35. CMS/DOS Support of DTFCD Macro (Part 1 of 2) Part 3. Conversational Monitor System (CMS) 295
r--- I Operand 1 ISEPASMB=YES 1 ISSELECT=n 1 ITYPE=xxxxxx I Sta tus I Description IDTFCD is to be assembled separately. * IIgnored. * IInput or output. 1--------------------------------------------------------------------------- IWORKA=YES I 11/0 records are processed in work areas I instead of the 110 areas. Figure 35. CMS/DOS support of DTFCD Macro (Part 2 of 2) CMS/DOS supports all of the operands of the tTFCN macro. Figure 36 describes the operands of the DTFCN macro and their support under CMS/DOS. The status column is blank because the CMS/DOS and DOS/VS support of DTFCN are the same. I Operand I IDEVADDR=SYSxxx I I I IOAREA1=xxxxxxxx I IBLKSIZE=nnn I , I I IINPSIZE=nnn I I I MODNAME=xxxxxxxx RECFORM=xxxxxx RECSIZE= (nn) TYPEFLE=xxxxxx IWORKA=YES L !Statusl Description ISymbolic unit for the console used for this I file. IName of I/O area. ILength in bytes of I/O area (for PUTR macro usage, length of output part of I/O area). I If RECFORM=UNDEF, maximum is 256. If I omitted, 80 is default. ILength in bytes for input part of I/O area I for PUTR macro usage. ILogic module name for this DTF. If omitted, I IOCS generates a standard name. I IThe logic module is generated as part of I the DTF. I (FIXUNB or UNDEF). If omitted, FIXUNB is I default. IRegister number if RECFORM=UNDEF. General I registers 2 through 12, enclosed in I parentheses. I (I NPUT, OUTPUT, or CMBND). Input processes I both input dnd output. CMBND must be I specified for PUTR macro usage. If omitted, I :NPUT is default. IGET or PUT specifies work area. Figure 36. eMS/DOS support of DTFCN macro. 296 IBM System programmer's Guide
VM370 System Programmers Guide (Rel6)
Page315(338 of 430)
Operand ! IBLKSIZE=nnnnn 1 IStatusl ILength of , 3-2,767) .. Description one I/O area in bytes (maximum = 1------------------------------------------------------------------- iDEVADDR=SYSxxx I I I EOFADDR=XXXXXXxx ... _'L._'':_ unit .... ...... _"'- drive I.:JI IU J.JV.1..1.\.., .L VJ.. l..Qt'--= I.l;:>cu I file .. IName of your end-of-file routine .. .... ... ".;,.. J..VJ.. l..u .... .:l 1------------------------------------------------------------------- IFILABL=XXXX 1 I 1 * I (NO, STD, or NSTD).. If NSTD specified, I include LABADDR. User label routines are I supported only for header labels on input I tapes. 1------------------------------------------------------------------- I IOAREA1=xxxxxxxx !Name of first I/O area .. i I ASCII=YES * INot supported. 1------------------------------------------------------------------- IBUFOFF=nn I ICKPTREC=YES 1 I ERREXT=YES ERROPT=xxxxxxxx HDRINFO=YES IOAREA2=xxxxxXXX IOREG= (nn) 1 ILABADDR=xxxxxxxx I I 1 I * * * INot supported. ICheckpoint records are interspersed with I input data records. IOCS bypasses I checkpoint records. IAdditional errors and ERET are desired. ; (IGNORE, SKIP, or name of error routine). I Prevents job termination on error records. INot supported. IIf two I/O areas are used, the name of the I second area. IRegister number. Use only if GET or PUT I does not specify a work area or if two I/O I areas are used. Omit WORK!.. General I registers 2 through 12, enclosed in I parentheses. IName of your label routine if FIL!BL=NSTD, ! or if FILABL=STD and user-standard labels I are processed. User label routines I are supported only for header labels on I input tapes. 1--------------------------------------------------------------------- ILENCHK=YES * INot supported. 1------------------------------------------------,--------------------- I MODNAME=xxxxxxxx I NOTEPNT=xxxxxx RDONLY=YES READ=xxxxxxx * IName of MTMOD logic module for this DTF .. If J omitted, IOCS generates standard name. I (YES or POINTS). YES if NOTE, POINTW, I POINTR, or POINTS macro used.. POINTS if I only POINTS macro used .. IGenerate read-only module. Requires a J module save area for each routine using 1 the mod ule .. ICMS/DOS only supports READ=FCRWARD .. Figure 38. CMS/DOS Support of DTFMT Macro (Part 1 of 2) Part 3. Conversational Monitor System (CMS) 299
r 1 Operand IStatusl Description 1---------------------------------------------------------------------- RECFORM=xxxxxx RECSIZE=nnnn REWIND=xxxxxx SEPASMB=YES TPMARK=NO TYPEFLE=xxxxxx VARBLD=(nn) WLRERR=xxxxxxxx WORKA=YES 1 (FIXUNB, FIXBLK, VARUNB, VARBLK, SPNUNB, 1 SPNBLK, or UNDEF). For work files use , FIXUNB or UNDEF. If omitted, FIXUNB is I assumed. IIf RECFORM=FIXBLK, number of characters in the record. If RECFORM=UNDEF, register number. Not required for other records. General registers 2 through 12, enclosed in parentheses. I (UNLOAD or NORWD). Unload on CLOSE or I end-of-volume, or prevent rewinding. If I omitted, rewind only. IDTFMT is to be assembled separately. IPrevent writing a tapemark ahead of data I records if FILABL=NSiD or Ne. I (INPUT, OUTPUT, or WORK). If omitted, I INPUT is default. IRegister number, if RECFORH=VARBLK and 1 records are built in the output area. I General registers 2 through 12 are enclosed I in parentheses. IName of wrong-length record routine. IGET or PUT specifies a work area. Omit I IOREG. Figure 38. CMS/DOS Support of DTFMT Macro (Part 2 of 2) CMS/DOS does not support the ASOCFLE, ERROPT=IGNORE, and FUNC operands of the DTFPR macro. Figure 39 describes the operands of the DTFPR macro and their support under CMS/DOS. An asterisk (*) 1n the status column indicates that CMS/DOS support differs from DOS/VS support. 300 IBM VM/370 System Programmer's Guide
Operand ! IBLKSIZE=nnnnn 1 IStatusl ILength of , 3-2,767) .. Description one I/O area in bytes (maximum = 1------------------------------------------------------------------- iDEVADDR=SYSxxx I I I EOFADDR=XXXXXXxx ... _'L._'':_ unit .... ...... _"'- drive I.:JI IU J.JV.1..1.\.., .L VJ.. l..Qt'--= I.l;:>cu I file .. IName of your end-of-file routine .. .... ... ".;,.. J..VJ.. l..u .... .:l 1------------------------------------------------------------------- IFILABL=XXXX 1 I 1 * I (NO, STD, or NSTD).. If NSTD specified, I include LABADDR. User label routines are I supported only for header labels on input I tapes. 1------------------------------------------------------------------- I IOAREA1=xxxxxxxx !Name of first I/O area .. i I ASCII=YES * INot supported. 1------------------------------------------------------------------- IBUFOFF=nn I ICKPTREC=YES 1 I ERREXT=YES ERROPT=xxxxxxxx HDRINFO=YES IOAREA2=xxxxxXXX IOREG= (nn) 1 ILABADDR=xxxxxxxx I I 1 I * * * INot supported. ICheckpoint records are interspersed with I input data records. IOCS bypasses I checkpoint records. IAdditional errors and ERET are desired. ; (IGNORE, SKIP, or name of error routine). I Prevents job termination on error records. INot supported. IIf two I/O areas are used, the name of the I second area. IRegister number. Use only if GET or PUT I does not specify a work area or if two I/O I areas are used. Omit WORK!.. General I registers 2 through 12, enclosed in I parentheses. IName of your label routine if FIL!BL=NSTD, ! or if FILABL=STD and user-standard labels I are processed. User label routines I are supported only for header labels on I input tapes. 1--------------------------------------------------------------------- ILENCHK=YES * INot supported. 1------------------------------------------------,--------------------- I MODNAME=xxxxxxxx I NOTEPNT=xxxxxx RDONLY=YES READ=xxxxxxx * IName of MTMOD logic module for this DTF .. If J omitted, IOCS generates standard name. I (YES or POINTS). YES if NOTE, POINTW, I POINTR, or POINTS macro used.. POINTS if I only POINTS macro used .. IGenerate read-only module. Requires a J module save area for each routine using 1 the mod ule .. ICMS/DOS only supports READ=FCRWARD .. Figure 38. CMS/DOS Support of DTFMT Macro (Part 1 of 2) Part 3. Conversational Monitor System (CMS) 299
r 1 Operand IStatusl Description 1---------------------------------------------------------------------- RECFORM=xxxxxx RECSIZE=nnnn REWIND=xxxxxx SEPASMB=YES TPMARK=NO TYPEFLE=xxxxxx VARBLD=(nn) WLRERR=xxxxxxxx WORKA=YES 1 (FIXUNB, FIXBLK, VARUNB, VARBLK, SPNUNB, 1 SPNBLK, or UNDEF). For work files use , FIXUNB or UNDEF. If omitted, FIXUNB is I assumed. IIf RECFORM=FIXBLK, number of characters in the record. If RECFORM=UNDEF, register number. Not required for other records. General registers 2 through 12, enclosed in parentheses. I (UNLOAD or NORWD). Unload on CLOSE or I end-of-volume, or prevent rewinding. If I omitted, rewind only. IDTFMT is to be assembled separately. IPrevent writing a tapemark ahead of data I records if FILABL=NSiD or Ne. I (INPUT, OUTPUT, or WORK). If omitted, I INPUT is default. IRegister number, if RECFORH=VARBLK and 1 records are built in the output area. I General registers 2 through 12 are enclosed I in parentheses. IName of wrong-length record routine. IGET or PUT specifies a work area. Omit I IOREG. Figure 38. CMS/DOS Support of DTFMT Macro (Part 2 of 2) CMS/DOS does not support the ASOCFLE, ERROPT=IGNORE, and FUNC operands of the DTFPR macro. Figure 39 describes the operands of the DTFPR macro and their support under CMS/DOS. An asterisk (*) 1n the status column indicates that CMS/DOS support differs from DOS/VS support. 300 IBM VM/370 System Programmer's Guide