|
  
Install the CP Component:
This section describes how to install the SafeAccess CP Component. The CP Component should be loaded into CP just after IPL time each time the system is IPLed.
Note: It is important to ensure that the CP Component is loaded into CP before any SafeAccess migrated minidisks are needed by any users on the system or before any users load the SafeAccess user component via SACUC LOAD.
The SafeAccess CP Component consists of the following files:
SACLDCP EXEC - Utility to load the CP Component
SACnnn TXTLIB - Programs loaded by the SACLDCP EXEC using the CP Exit facility
Where nnn is the z/VM release number for your release of z/VM.
Safe Software recommends having OPERATOR load the SafeAccess CP Component at IPL time by running the SACLDCP EXEC from its PROFILE EXEC.
The issuer of SACLDCP requires CP CLASS A, or the appropriate privilege to issue the following CP commands:
· ASSOCIATE
· CPACCESS
· CPRELEASE
· CPXLOAD
· CPXUNLOAD
· DEFINE DIAGNOSE
· DISABLE EXIT
· DISASSOCIATE
· MODIFY CMD
· MODIFY DIAGNOSE
· QUERY CPXLOAD
· XAUTOLOG
Step 1: Logon to the OPERATOR id.
Step 2: Verify CP entry points.
Issue the CP QUERY commands listed below and verify that the entry points listed below match the entry points for your system.
CP COMMAND
|
CP Entry Point
|
CP QUERY CPCMDS LINK
|
HCPLNKIN
|
CP QUERY CPCMDS DETACH
|
HCPDTCMD
|
CP QUERY CPCMDS QUERY VIRTUAL SUBC DASD
|
HCPQVCDA
|
CP QUERY CPCMDS QUERY VIRTUAL SUBC ALL
|
HCPQVAAL
|
CP QUERY CPCMDS QUERY SUBC LINKS
|
HCPQVCLI
|
CP QUERY CPCMDS QUERY SUBC MDISK
|
HCPQMDSK
|
CP QUERY CPCMDS QUERY SUBC VIRTUAL
|
HCPQVDVD
|
CP QUERY CPCMDS ATTACH
|
HCPATCMD
|
CP QUERY CPCMDS REDEFINE
|
HCPRDFDV
|
CP QUERY CPCMDS DEFINE
|
HCPDEFIN
|
CP QUERY CPCMDS GIVE
|
HCPGIVPR
|
CP QUERY DIAG 24
|
HCPDVTAL
|
CP QUERY DIAG 88
|
HCPVDG88
|
CP QUERY DIAG 210
|
HCPDVTDC
|
|
CP QUERY DIAG 1DC
|
Response: HCPQDG2751E Diagnose code 01DC does not exist
|
If any of the above entry points do not match the results from your system, contact Safe Software before proceeding with the SafeAccess installation.
Step 3: XEDIT OPERATOR's PROFILE EXEC and insert the following statements:
'CP LINK SAFEACC 192 vaddr RR' /*Link & access SAC code */ 'ACCESS vaddr fm'
'EXEC SACLDCP LOAD' /* Load the SAC CP Component */
'CP XAUTOLOG SAFEACC' /* Start the SAFEACC server */
'EXEC SACUC LOAD' /* Load the SAC User Component */
'RELEASE' fm '(DET'
In the above statements vaddr may be any virtual address that is not used by OPERATOR and fm may be any file mode that is not used by OPERATOR.
Note: The SafeAccess CP Component is now set to be loaded whenever the system is IPLed.
Step 4: Educate operations staff on SACLDCP
The SACLDCP has two safeguards built into it to guard against unexpected results.
The first helps to prevent running SACLDCP while the SafeAccess database is active. Reloading the SafeAccess CP Component while the SafeAccess database is active causes all active users to lose their links. If SACLDCP is run on a system that already has the SafeAccess CP Component loaded, the issuer will be prompted:
Ready;
sacldcp
SafeAccess product code loaded in CP
Unloading the product code will cause the SafeAccess
database to be unloaded for all running users.
Enter Y to continue, N to stop
At this point the issuer should only enter Y if they wish to cause that SafeAccess Database to be unloaded and the SafeAccess CP Component reloaded. If this is not the intended result, the issuer should response with N.
The second safeguard is used in situations where the system has terminated and restarted after running for less than 20 minutes. The SACLDCP utility maintains the last date/time that it was run in a GLOBALV file and when it determines that less than 20 minutes has passed since the last time the SafeAccess CP Component was loaded it prompts the issuer:
SACLDC0199I SafeAccess CP Component unloaded from CP system storage.
SACLDC0187W Less than 20 minutes has passed since the last time the SafeAccess CP Code was loaded.
SACLDC0186R Do you wish to continue (Y/N)?
At this point the issuer should enter Y to cause a load to occur and N to skip loading the SafeAccess CP Component.
Step 5: Load the SafeAccess CP component into CP
Link and access the SAFEACC 192 mdisk. Then enter SACLDCP LOAD. This causes the SafeAccess CP component to be loaded into CP. The SafeAccess CP component is now active.
|
