z/OS JES3 Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Programming Considerations

z/OS JES3 Customization
SA32-1006-00

Register 13 points to data CSECT IATODWD, which contains the data set data (data set ddname, data set class, and data set priority). Register 1 points to an address mapped by IATYOSE, which contains the data set attributes.

This installation exit should issue the following macro instructions: IATXOS0O LABEL=NONE to open the device, IATXOSP to write data, and IATXOSCO LABEL=NONE to close the device. If an open or write is rejected, the exit should issue IATXOSCO and return a rejection to the caller. A rejection that is returned from IATXOSP for an AFP printer may indicate that the current data set or job has just been changed. The installation exit should pass the rejection to the caller.

For an AFP printer, the address in the field FCTRQAD should not be explicitly or implicitly used. This RESQUEUE address may not be associated with the job currently active at the channel. Field WTRDRSQ in data CSECT IATODWD contains the address of the RESQUEUE for the job active on the writer. This address must be specified for all macros that require a RESQUEUE address (such as JDSGET) or that use the RESQUEUE contained in FCTRQAD to access other job-related control blocks. For example, the AWRITE macro with a TATPTR parameter specified uses the TAT FDB in the RESQUEUE contained in FCTRQAD.

Upon entry, the RQOSESUP for the RQ in WTRDRSQ is off (set to zero). Upon exit, RQOSESUP should be in the off state also.

The OSE is passed to IATUX21 is a copy of the disk OSE. You can access this information without using the IATXOSUP macro. Changes made to this OSE are not made to the job's disk OSE chain or in any storage representation of the disk OSE.

If you code the IATXOSUP macro in this installation exit, follow the step-by-step process in the description for the IATXOSUP macro.

The SWBTUREQ service can be used to obtain access to the output distribution keywords.
  • NAME
  • ROOM
  • BUILDING
  • DEPT
  • ADDRESS
  • TITLE
The SWB's for input to the SWBTUREQ service are:
  • WTRSWBP - address of the SWBTU pointer list
  • WTRSWBN - number of SWBTUs in the pointer list.

See CSECT Name: IATUX20 (Create and Write Job Headers for Job Output) for an example of how to use the SWBTUREQ service.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2013