z/OS MVS Programming: Assembler Services Reference ABE-HSP
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


BLSABDPL — Map dump formatting exit data

z/OS MVS Programming: Assembler Services Reference ABE-HSP
SA23-1369-00

Description

The BLSABDPL macro maps several structures that are part of the interface to dump formatting exits. Dump formatting exits are routines that receive control from one of the following:
  • The interactive problem control system (IPCS)
  • The SNAP macro or SNAPX macro
  • The ABEND macro.
BLSABDPL maps the following structures:
  • The processor status record
  • The storage access parameter list
  • The select ASID parameter list
  • The control block and format model processor parameter list
  • The ECT parameter list
  • The format parameter list extension block.

See z/OS MVS IPCS Customization for information about IPCS exit services; see z/OS MVS Data Areas in z/OS Internet Library at http://www.ibm.com/systems/z/os/zos/bkserv/ for a mapping of the BLSABDPL data area.

Environment

Because BLSABDPL is not an executable macro, there are no specific environment requirements.

Programming requirements

None.

Restrictions

None.

Register information

Because BLSABDPL is not an executable macro, there is no need to save and restore register contents.

Performance implications

None.

Syntax

The standard form of the BLSABDPL macro is written as follows:

Syntax Description
   
   name name: Symbol. Begin name in column 1.
   
␢ One or more blanks must precede BLSABDPL.
   
BLSABDPL  
   
␢ One or more blanks must follow BLSABDPL.
   
   ,AMDCPST=YES  
   ,AMDCPST=NO Default: AMDCPST=NO
   
   ,AMDEXIT=YES Default: AMDEXIT=YES
   ,AMDEXIT=NO  
   
   ,AMDOSEL=YES Default: AMDOSEL=YES
   ,AMDOSEL=NO  
   
   ,AMDPACC=YES Default: AMDPACC=YES
   ,AMDPACC=NO  
   
   ,AMDPECT=YES Default: AMDPECT=YES
   ,AMDPECT=NO  
   
   ,AMDPFMT=YES Default: AMDPFMT=YES
   ,AMDPFMT=NO  
   
   ,AMDPSEL=YES Default: AMDPSEL=YES
   ,AMDPSEL=NO  
   
   ,DSECT=YES Default: DSECT=YES
   ,DSECT=NO  
   

Parameters

The parameters are explained as follows:

,AMDCPST=YES
,AMDCPST=NO
Specifies whether the format of the CPU status data, available through the IPCS storage access services, is to be mapped (YES) or suppressed (NO).

When this parameter is not specified, the default is NO.

The system uses DSECT AMDCPMAP to map the format of CPU status data, AMDCPST = YES, and ignores the DSECT = NO option when specified.

,AMDEXIT=YES
,AMDEXIT=NO
Specifies whether the common exit parameter list, BLSABDPL, is to be mapped (YES) or suppressed (NO).

When this parameter is not specified, the default is YES.

The common exit parameter list contains two parts: ABDPL and ADPLEXTN. DSECT=YES causes DSECT statements to be generated for both. DSECT=NO suppresses the DSECT statements and causes ABDPL and ADPLEXTN to be defined as the labels associated with the first bytes described in the ABDPL and ADPLEXTN exit parameter lists.

,AMDOSEL=YES
,AMDOSEL=NO
Specifies whether the select ASID service output data available under IPCS is to be mapped (YES) or suppressed (NO).

When this parameter is not specified, the default is YES.

When the DSECT=NO option is specified, it is ignored. The select ASID parameter list is mapped by DSECT ADPLPSEL.

The system uses DSECT ADPLPSEL to map the select ASID parameter list, AMDOSEL = YES, and ignores the DSECT = NO option when specified.

,AMDPACC=YES
,AMDPACC=NO
Specifies whether the storage access service parameter list is to be mapped (YES) or suppressed (NO).

When this parameter is not specified, the default is YES.

The storage access service parameter list is described as ADPLPACC. DSECT=YES causes DSECT statements to be generated for ADPLPACC. DSECT=NO suppresses the DSECT statements and causes ADPLPACC to be defined as the label associated with the first byte described in the storage access service parameter list.

,AMDPECT=YES
,AMDPECT=NO
Specifies whether the ECT service parameter list is to be mapped (YES) or suppressed (NO).

When this parameter is not specified, the default is YES.

The ECT service parameter list is described as ADPLPECT. DSECT=YES causes DSECT statements to be generated for ADPLPECT. DSECT=NO suppresses the DSECT statements and causes ADPLPECT to be defined as the label associated with the first byte described in the ECT service parameter list.

,AMDPFMT=YES
,AMDPFMT=NO
Specifies whether the parameter list used by both the control block formatter and the format model processor services is to be mapped (YES) or suppressed (NO).

When this parameter is not specified, the default is YES.

The parameter list used by both the control block formatter and the format model processor services is described as ADPLPFMT. DSECT=YES causes DSECT statements to be generated for ADPLPFMT. DSECT=NO suppresses the DSECT statements and causes ADPLPFMT to be defined as the label associated with the first byte described in the parameter list.

,AMDPSEL=YES
,AMDPSEL=NO
Specifies whether the select ASID service parameter list is to be mapped (YES) or suppressed (NO).

When this parameter is not specified, the default is YES.

The ASID service parameter list is described as ADPLPSEL. DSECT=YES causes the DSECT statements to be generated for ADPLPSEL. DSECT=NO suppresses the DSECT statements and causes ADPLPSEL to be defined as the label associated with the first byte described in the ASID service parameter list.

,DSECT=YES
,DSECT=NO
Specifies whether parameter lists mapped by BLSABDPL are to be mapped as DSECTs (YES) or not (NO).

When this parameter is not specified, the default is YES.

Note: Output data from services can also be mapped by BLSABDPL. Output data are always mapped as DSECTs. These DSECTs cannot be suppressed by DSECT=NO. To determine whether DSECT=NO can suppress a specific DSECT, see the above parameters.

Example

Code the macros to invoke the select ASID service routine. This routine generates a list of selected address spaces within a dump by reserving space for an initialized select ASID service parameter list and by defining the mapping of the ABDPL for the user-written exit routine. 
BLSABDPL DSECT=NO,AMDEXIT=NO,AMDOSEL=NO,AMDPACC=NO,
     AMDPFMT=NO,AMDPECT=NO,AMDPSEL=YES

Go to the previous page Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites



Copyright IBM Corporation 1990, 2014