z/OS Security Server RACF Callable Services
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


GSS-API functions (Function code 2):

z/OS Security Server RACF Callable Services
SA23-2293-00

The context and credential handles used by these services are not the same as the context and credential handles used by the GSS-API C functions and cannot be used interchangeably. The input and output tokens used by these functions, however, are compatible with the input and output tokens used by the GSS-API C functions, which means that a token created by a R_GenSec service can be processed by a GSS-API C functions and vice versa.

All references to addresses in the description of this callable service are considered to be 4 bytes in length for AMODE 31 callers and 8 bytes for AMODE 64 callers.

Storage allocations performed by this service will be in the home address space and will be owned by the task issuing the call to R_GenSec. It is up to the caller to free any storage that is allocated and returned to the caller.

Any GSS-API error code which can be generated by the IBM® Kerberos runtime could be returned for the major and minor status code parameters. Refer to the messages and codes topic in the z/OS Integrated Security Services Network Authentication Service Administration for a description of the various error codes. Refer to the GSS-API function descriptions in the z/OS Integrated Security Services Network Authentication Service Programming for a description of the GSS-API functions, associated input and output parameters and status codes.

Flag Values:
Flag name Value
GSS_C_DELEG_FLAG 1
GSS_C_MUTUAL_FLAG 2
GSS_C_REPLAY_FLAG 4
GSS_C_SEQUENCE_FLAG 8
GSS_C_CONF_FLAG 16
GSS_C_INTEG_FLAG 32
GSS_C_ANON_FLAG 64
GSS_C_PROT_READY_FLAG 128

Status codes:

Status codes are returned in the following format:
Calling Error Routine Error Supplementary Information
Bit 0							7 8	
15 16
31
Status codes Bit position within status type
Calling Error  
GSS_S_CALL_INACCESSIBLE_READ 1
GSS_S_CALL_INACCESSIBLE_WRITE 2
GSS_S_CALL_BAD_STRUCTURE 3
Routine Error  
GSS_S_COMPLETE 0
GSS_S_BAD_MECH 1
GSS_S_BAD_NAME 2
GSS_S_BAD_BINDINGS 4
GSS_S_BAD_SIG 6
GSS_S_NO_CRED 7
GSS_S_NO_CONTEXT 8
GSS_S_DEFECTIVE_TOKEN 9
GSS_S_DEFECTIVE_CREDENTIAL 10
GSS_S_CREDENTIALS_EXPIRED 11
GSS_S_FAILURE 13
Supplemental Information  
GSS_S_CONTINUE_NEEDED 0
GSS_S_DUPLICATE_TOKEN 1
GSS_S_OLD_TOKEN 2
Miscellaneous definitions:
Name Value
GSS_NO_CREDENTIAL 0
GSS_C_NO_BUFFER 0
GSS_C_NO_CONTEXT 0
GSS_C_INDEFINITE x'FFFFFFFF'

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014