PAM Management Programming Manual

SPI Programming Considerations for the PAM
Subsystem
PAM Management Programming Manual—142481
3-2
Definition Files
The definitions in a TAL, C, Pascal, or COBOL85 definition file are grouped into
sections, so that only those definitions that are needed can be included in the application.
For TACL, the entire definition file must be used. For more information about how
definition files are accessed by your application, refer to the SPI Programming Manual.
Writers of management applications that use SPI must use the programming language’s
version of each definition file. Definition files are named according to the following
convention:
subsys
is the three-character code identifying the subsystem or other software component to
which these definitions belong. PAM is the code used to identify the definitions for
the PAM subsystem.
The last characters of each file name denote the language in which the definitions in the
file are coded. The files are located on the disk volume chosen by your site. The default
disk volume is $SYSTEM.
An application that sends DSM commands to and receives responses from the PAM
subsystem needs the following definition files in the appropriate programming language:
•
The SPI (ZSPI) definition file, which contains the standard SPI definitions
•
The data communications (ZCOM) definition file, which contains the standard data
communications definitions
•
The PAM subsystem (ZPAM) definition file, which contains definitions for the PAM
subsystem
•
The definition file(s) for any other subsystem(s) with which your PAM management
application communicates
•
Other definition files used by a particular subsystem if your application needs
them—for instance, files defining tokens in passthrough error lists if your
application examines these error lists
An application that retrieves event messages issued by the PAM subsystem needs all the
definition files listed above, plus the following files:
•
The EMS (ZEMS) definition file, which contains standard EMS definitions
•
Guardian (ZGRD) definition file
•
File-system (ZFIL) definition file
ZSPIDEF.ZsubsysC
ZSPIDEF.ZsubsysCOB
ZSPIDEF.ZsubsysDDL
ZSPIDEF.ZsubsysTAL
ZSPIDEF.ZsubsysPAS