List of programming requirements for invoking the service.
- The CICS® VR
file copy notification service can be invoked by the high-level languages
supported by Language Environment® and by assembler language callers.
- For assistance when coding the CICS VR file copy notification service
in assembler language, CICS VR provides the caller with a mapping macro DWW2NRRC
located in SDWWSORC for the non-server related return code and reason code
equates.
- The caller of the CICS VR file copy notification service can have an established
FRR.
- The CICS VR
file copy notification service can be invoked in one of the following ways:
- A CALL statement is coded in the invoking application. The library (SDWWCSSL)
that contains the CICS VR file copy notification service must either be
in the Link List or referenced by JOBLIB, STEPLIB, or the task library when
the invoking application is link-edited.
- The invoking application can issue a LINK or LOAD/CALL to the CICS VR file
copy notification service. This technique ensures that your program always
gets the latest copy of the service. The library (SDWWCSSL) that contains
the file copy notification service must be in the Link List or referenced
by JOBLIB, STEPLIB, or the task library of the invoking application.
Note: This document describes calling the CICS VR file copy notification service
from a nonreentrant program written in assembler language. See z/OS® MVS™ Programming:
Assembler Services Reference, Volume 1 (ABEND-HSPSERV) for information
on using the CALL macro. Code the MF parameter of the CALL macro to generate
reentrant code. For information on using CALL in programs written in high-level
languages, refer to the applicable language document.