z/OS MVS Using the Subsystem Interface
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


BULK MODIFY Requests

z/OS MVS Using the Subsystem Interface
SA38-0679-00

With a BULK MODIFY request, the application thread can select SYSOUT data set(s) for modifications. Modification of data sets matching the input selection criteria occurs with the setting of information in flag byte SSS2UFLG.
  • SSS2SETC - class update
    • The class of each data set is changed to the specified class in the SSS2CLAS field.
  • SSS2DELC - delete processing
    • Each data set is deleted.
  • SSS2ROUT - destination update
    • The destination of each data set is changed to the specified destination in the SSS2DES2 field.
  • SSS2RLSE - release processing
    • Each data set is moved to the WRITER queue in JES3, and marked non-held in JES2.
    • Release processing is applicable only to data sets on the JES3 Output Service HOLD queue, or for those data sets with dispositions of HOLD or LEAVE for JES2.

Processing for a BULK MODIFY request occurs for each data set matching the application thread's selection criteria. It is important to understand job boundaries can be crossed.

There is NO posting of the ECB after a BULK MODIFY request has been processed by JES.

In certain situations the BULK MODIFY request may not be successful. This is normal, and can occur if the output being released/returned is BUSY .There is no ECB posted and no error code returned; JES2 will always return to the caller, but the actual request may be partially or completely bypassed.

To assure that the desired changes are processed, it may be necessary to query the status of a job or specific job output, and if it appears that a request did not complete, then the BULK MODIFY request can be reissued.

You must provide at least SAF UPDATE authority for the JESSPOOL resource class to the application thread in order to correctly issue the SAPI BULK MODIFY call.

If the application does not provide for multi-tasking, it must follow the protocol shown in Figure 1. If the application does provide for multi-tasking, each thread in the application address space must follow the protocol shown in Figure 1.
Figure 1. Protocol for the SAPI BULK MODIFY CallProtocol for the SAPI BULK MODIFY Call
Programming Considerations for BULK MODIFY
  • Supplying an ECB address in field SSS2ECBP does not result in the posting of the ECB by JES for a BULK MODIFY request.
  • A BULK MODIFY request can be initiated after the application thread initialization is complete, immediately following a prior BULK MODIFY request, immediately following a COUNT request or immediately following receiving an EOD response to a PUT/GET request.
  • After JES returns to the application thread after processing the BULK MODIFY request, the application thread can do one of the following:
    • Issue another IEFSSREQ request, possibly after changing its selection criteria.
    • Issue another IEFSSREQ request with the SSS2CTRL flag set indicating the application thread is terminating.
    • Issue a COUNT request.
    • Issue a PUT/GET request.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014