Exit Services

The following services are recommended.

Service	Use When You Want to:	Invoked Through:
Add Symptom Service	Generate symptoms from stand-alone dumps, SVC dumps, or ABEND dumps written to SYSMDUMP data sets	Exit services router
Control Block Formatter Service	Format and print a complete data area in one invocation	Exit services router
Control Block Status (CBSTAT) Service	Invoke all CBSTAT exit routines for a requested data area	Exit services router
Contention Queue Element (CQE) Create Service	Create contention queue elements (CQE) that are called by ANALYZE exit routines	Exit services router
Equate Symbol Service	Create a symbol entry in the symbol table	Exit services router
Exit Control Table (ECT) Service	Invoke an exit routine within an exit routine, or invoke a group of exit routines	Exit services router
Expanded Print Service	Display data at a terminal and write data to the IPCS print data set	Exit services router
Format Model Processor Service	Format and print an entire data area using a control block model	Exit services router
Get Symbol Service	Retrieve symbols from the symbol table Initialize the BLSRESSY macro for your exit routine	Exit services router
Locate-Mode SWA Manager	Convert 3-byte SWA virtual addresses (SVAs) to addresses and related data	Two ways: Issue a LINK macro. Through CALL after the use of a LOAD macro.
Name Service	Describe the data space and/or address space associated with a specified STOKEN	Exit services router
Name/Token Lookup Service	Retrieve the token from a name/token pair	Exit services router
Select Address Space Identifier (ASID) Service	Scan ASCBs in a dump and generate a list of entries for selected address spaces	Exit services router
Standard Print Service	Print a line of output. Note: Use expanded print service, especially for exit routines that issue messages with prefixes.	Exit services router
Storage Access Service	Access data in a dump and read dump data into storage	Exit services router
Storage Map Service	Process storage map entries and obtain the data they represent	Exit services router
Symbol Service	Process symbols and obtain the data they represent	Exit services router
Table of Contents Service	Add entries to the table of contents	Exit services router
WHERE Service	Determine the system area in which an address resides	Exit services router
Obtaining Information About Coupling Facility Structures	Search for information about coupling facility structures	Issue an IXLZSTR macro
Obtaining Information About Loaded Modules	Search for information about loaded modules	Issue a CSVINFO macro
Quiesce IPCS Transaction	Quiesce a transaction that is currently being processed by IPCS.	Three ways: From an authorized program, different task: Schedule an IRB. From an authorized program, same task: Issue a LOAD macro, then a SYNCH macro. From an unauthorized program, same task: Issue a LINK macro or issue a LOAD macro followed by a call.
TOD Clock Service	Obtain time-of-day (TOD) clock image	Two ways: Issue a LINK macro. Issue a LOAD macro followed by a call.
17-Character Time Stamp Service	Obtain 17-character EBCDIC time stamp	Two ways: Issue a LINK macro. Issue a LOAD macro followed by a call.
26-Character Time Stamp Service	Obtain 26-character EBCDIC time stamp	Two ways: Issue a LINK macro. Issue a LOAD macro followed by a call.

Services Supporting 64-Bit Addresses and Lengths

With OS/390® Release 10 and higher, the following IPCS exit services support the processing of 64-bit addresses and lengths in dump data set information:

Control block formatter
Control block status (CBSTAT)
Contention queue element create (CQE)
Format model processor
Storage map
Symbol
WHERE

Services Not Recommended

These exit services were provided in systems before MVS/SP Version 3 and are maintained in later systems for compatibility. These exit services are not recommended.

Note: IPCS Exit Services Supported for Compatibility describes how to invoke these services directly through pointers in the BLSABDPL exit parameter list. These services cannot be invoked through the exit services router.

The format service is not the same as the control block formatter or the format model processor, which replace it.

Service Maintained	Use When You Want to:	Invoked Through:
Dump Index Service	Print a table of contents for each of the significant parts. Use instead the table of contents service.	Load register 15 with contents of ADPLNDX. Use BALR instruction to branch to address in register 15.
Format Service	Convert data to printable hexadecimal, if necessary, and format data in the output buffer. Use instead the control block formatter or format model processor service.	Obtain the address of the format service from field ADPLFRMT in the BLSABDPL parameter list. Use standard linkage conventions to invoke the service.
Old Storage Access Service	Obtain data from a dump data set. Use instead: The storage access service, for exit routines that do SNAP or both SNAP and IPCS formatting The storage map or symbol service, for exit routines that do IPCS formatting	Two ways: Exit service router. Obtain the address of the storage access routine from the ADPLMEMA field of the BLSABDPL exit parameter list. Use standard linkage conventions to invoke the service.
Print Service	Print an output line of a dump. Use instead the standard print or expanded print.	Obtain the address of the print service from the ADPLPRNT field of the BLSABDPL exit parameter list. Use standard linkage conventions to invoke the service.
Summary Dump Data Access Service	Access the summary dump data contained in an SVC dump. Use instead the symbol service, with an ACC code identifying the summary dump as desired storage.	Use a CALL macro to pass control to IEAVTFRD, using standard linkage contentions. Register 1 must contain the address of the exit parameter list.