Parameters

FDB=

Specifies the address of the FDB of the first SRF in the chain.

TATPTR=

Specifies the address of the job or data set track allocation table (TAT) FDB to be used. If the SRFs obtain their tracks from the single track table (STT), FDB=MNTRKFDB should be coded. When the SRF chain consists entirely of records belonging to the job's TAT, the address of the job TAT FDB should be coded.

DISP=

Specifies the displacement into the SRF of the chain FDB, or a register containing the displacement in the low-order byte.

PUTBUF=

Specifies whether buffers are to be returned.

ID=

Specifies the name to be associated with the SRF. The ID length is limited to 4 characters. The ID is compared to the ID in the buffer before write.

OPTION=

Specifies that only modified buffers are to be written. If the PUTBUF=NO parameter is also specified, unmodified buffers are left unchanged. If the PUTBUF=YES parameter is specified with this parameter, unmodified buffers are released. The requester marks modified buffers with flag DMCDATMD in flag byte DMCFLAG4.

If the MODONLY option is specified, WRTCHAIN issues an IATXSIO macro for each record marked by the caller or by WRTCHAIN when new records were added. If the MODONLY option is omitted, WRTCHAIN flags all old records as modified and rewrites the entire chain by issuing IATXSIO macros.

After issuing the last IATXSIO, WRTCHAIN waits for the “I/O completed bit” in the SRF File Directory Entry.

ERROR=

This parameter specifies the address to which the macro processing routine returns if an error occurs. When control is passed to the address, register 0 contains a dump code and register 15 contains a return code, unless otherwise specified. The return codes and dump codes are described below. For a description of every dump code, see z/OS JES3 Diagnosis.

If an error occurs and ERROR was not specified, the dynamic support program (DSP) will be ended by using the FAILDSP macro.

NORMAL=

This parameter specifies that after the macro processing routine executes, the issuing program can resume execution at an instruction other than the instruction that immediately follows the macro.