Under z/OS® batch

Example: You can use the IBM-supplied cataloged procedure EDCDSECT to execute the DSECT utility as in the following example.

Figure 1. Running the DSECT Utility under z/OS batch

  KNOWN:   - The assembler source name is FRED.SOURCE(TESTASM).
           - The structure is to be written to FRED.INCLUDE(TESTASM).
           - The required DSECT Utility options are EQU(BIT).

  USE THE FOLLOWING JCL:
           //DSECT    EXEC PROC=EDCDSECT,
           //         INFILE='FRED.SOURCE(TESTASM)',
           //         OUTFILE='FRED.INCLUDE(TESTASM)',
           //         DPARM='EQU(BIT)'

EDCDSECT invokes the High Level Assembler to assemble the source that is provided with the ADATA option. It then executes the DSECT utility to produce the structure. It writes the structure to the data set that is specified by the OUTFILE parameter, unless the OUTPUT option is also specified. A report that indicates the options in effect and any error messages is written to SYSOUT.

If the assembler source requires macros or copy members from a macro library, include them on the SYSLIB DD for the ASSEMBLY step.

The parameters to the EDCDSECT procedure are:

Table 1. EDCDSECT procedure parameters
Parameter	Description
`INFILE`	Input assembler source data set name. This option must be provided.
`OUTFILE`	The data set name for the file into which the structure is written. If you do not specify an OUTFILE name, a temporary data set is generated.
`APARM`	High Level Assembler options.
`DPARM`	DSECT Utility options.