COMY: 64-bit enabled SAF callable services

This topic contains details for changes to the COMY data area for Validated Boot for z/OS. It contains only the section that was changed. For the complete data area, see z/OS Security Server RACF Data Areas.

COMY programming interface information

COMY is a programming interface.

COMY heading information

Common name: SAF Common Security Parameter List (64 bit)
Macro ID: IRRPCOMY
DSECT name: COMY, Start of changePGSN64,End of change RAUX64, PKIS64
Owning component: Resource Access Control Facility (SC1BN)
Eye-catcher ID: None
Storage attributes:
Subpool
N/A
Key
Any
Residency
Invoker's primary address space
Size:
Section
Size
COMY
56 bytes
Start of changePGSN64End of change
Start of change32 bytesEnd of change
PKIS64
60 bytes
RAUX64
80 bytes
Created by: Invoker of 64-bit enabled callable services
Pointed to by: Address of COMY is passed in register 1 when invoking 64-bit enabled callable services
Serialization:
None
Function: Maps the common input parameter list for the 64-bit RACF® and SAF callable services routers

COMY mapping

Table 1. Structure COMY
Offset
Dec
Offset
Hex
Type Len Name(Dim) Description
0 (0) STRUCTURE 0 COMY SAF enabled callable services.
0 (0) ADDRESS 8  COMY_WORKA_STOR@ Address of 1024 byte work area
8 (8) ADDRESS 8  COMY_SAFRC_ALET@ Address of ALET for SAF return code
16 (10) ADDRESS 8  COMY_SAFRC_STOR@ Address of SAF return code
24 (18) ADDRESS 8  COMY_RACRC_ALET@ Address of ALET for RACF return code
32 (20) ADDRESS 8  COMY_RACRC_STOR@ Address of RACF return code
40 (28) ADDRESS 8  COMY_RACSC_ALET@ Address of ALET for RACF reason code
48 (30) ADDRESS 8  COMY_RACSC_STOR@ Address of RACF reason code
PGSN64
0 (0) STRUCTURE 24 PGSN64 Mapping for PGSN64
0 (0) ADDRESS 8  PGSN64_NUM_PARMS@ Address of a fullword containing the total number of parameters included in COMY and PGSN64.
8 (8) ADDRESS 8  PGSN64_FUNC@ Address of a 2-byte function code. See data area COMP for the function code constants.
16 (10) ADDRESS 8  PGSN64_FUNC_PARML@ Address of the function specific parameter list corresponding to the function code. See z/OS® Security Server RACF Callable Services for function specific parameter lists for callable service R_PgmSignVer.
Start of change24End of change Start of change(18)End of change Start of changeADDRESSEnd of change Start of change8End of change Start of changePGSN64_FUNC_ATTR@End of change Start of changeAddress of a 4-byte variable that contains the attribute flags for the service.End of change
RAUX64
0 (0) STRUCTURE 152 RAUX64  
0 (0) ADDRESS 8  RAUX64_NUM_PARMS@ Address of a fullword containing the total number of parameters included in COMY and RAUX64.