MODIFY command

Use the MODIFY command to display information about the OnDemand server. The abbreviated version of the command is F.

Syntax

Parameters

procname: The member name of the cataloged procedure that is used to start the OnDemand server.
D,OAM: Display the status of the OAM threads.
D,CONFIG: Display the configuration of the server instance.
D,ENVAR: Display the environment variables for the server instance.
D,ICSF: Display whether you can encrypt data with the 128-bit AES cipher.

Examples (D,OAM)

The following example shows the output that is returned when you run the MODIFY D,OAM command to display the status of the OAM threads:

F ARSSOCKD,D,OAM

  ARS0375I 13.21.14 DISPLAY OAM                               
  DB2      DB1A     PLAN CBRIDBS    GENERAL      8 SLOW     1 
  TCB@     STATUS COLLECTION/OBJECT                           
  007CE6B0 IGDE   ARS.COLLECT                                 
                  JJA.L57.FAA*                                
                  START=13.16.59.963 STOP=13.17.00.021        
  007CE408 IGST   ARS.COLLECT                                 
                  JJA.L57.FAA1                                
                  START=13.16.39.001 STOP=13.16.39.009        
  007CE160 IG                                                 
  007CAE88 IG                                                 
  007CABE0 IG                                                 
  007CA938 IG                                                 
  007CA690 IG                                                 
  007CA3E8 IG                                                 
  007CA140 IS

Examples (D,CONFIG)

The following example shows the output that is returned when you run the MODIFY D,CONFIG command to display the configuration of the server instance.

Note: In the following example, the <CFG> are the operative lines of the ars.cfg from the SRVR_OD_CFG file The section started by the <CACHE> are the cache files from the SRVR_SM_CFG file.

F ARSSOCKD,D,CONFIG

ARS0391I 3.21.14 DISPLAY CONFIG
<@SRV@_ARCHIV9A>
PROTOCOL=2
PORT=1456
SRVR_INSTANCE=ARSDBA9A
SRVR_INSTANCE_OWNER=ARSUSE9A
SRVR_OD_CFG=/etc/ars/ars9a.cfg
SRVR_SM_CFG=/etc/ars/ars9a.cache
HOST=SVLSPIZ4
<CFG>
ARS_LANGUAGE=ENU
ARS_NUM_DBSRVR=4
ARS_TMP=/ars/ars9a/tmp
ARS_PRINT_PATH=/ars/ars9a/tmp
DB_ENGINE=DB2
ARS_DB_TABLESPACE=ARSTSPAC
ARS_NUM_OAMSRVR=4
ARS_OAM_DB1A=DB1A
ARS_OAM_PLAN=CBRIDBS
ARS_STORAGE_MANAGER=TSM
LIBPATH=/etc/ars/tsm2
DSMI_CONFIG=/etc/ars/tsm2/dsm.opt
DSMI_DIR=/etc/ars/tsm2
DSMI_LOG=/ars/ars9a/tmp
ARS_ORIGINAL_CODEPAGE=0037 
<CACHE>
SMFS1=/ars/ars9a/cache
SMFS_NUM=1

Examples (D,ENVAR)

The following example shows the output that is returned when you run the MODIFY D,ENVAR command to display the environment variables for the server instance.

F ARSSOCKD,D,ENVAR

ARS0392I 3.21.14 DISPLAY ENVAR
_XEE_HEAP_MANAGER=CEL4MCHK
ARS_ORIGINAL_CODEPAGE=0037
ARS_LANGUAGE=ENU
ARS_NUM_DBSRVR=4
ARS_TMP=/ars/ars9a/tmp
ARS_PRINT_PATH=/ars/ars9a/tmp
DB_ENGINE=DB2
ARS_DB_TABLESPACE=ARSTSPAC
ARS_NUM_OAMSRVR=4
ARS_OAM_DB1A=DB1A
ARS_OAM_PLAN=CBRIDBS
ARS_STORAGE_MANAGER=TSM
LIBPATH=/etc/ars/tsm2
DSMI_CONFIG=/etc/ars/tsm2/dsm.opt
DSMI_DIR=/etc/ars/tsm2
DSMI_LOG=/ars/ars9a/tmp
_EDC_ADD_ERRNO2=1

Example (D,ICSF)

The following example shows the output that is returned when you run the MODIFY D,ICSF command to display whether you can encrypt data with the 128-bit AES cipher.

F ARSSOCKD,D,ICSF

ARS0438I 14.11.51 DISPLAY ICSF          
CSFIQF RC=0, RSN=00000000, AES=1, FMID=HCR7780

RACF access authority and resource names

OnDemand verifies the authority of the operator to issue the command by issuing the CMDAUTH macro. When an operator issues an OnDemand command with a RACF profile, OnDemand determines the resource-name that matches the command and passes that resource-name to RACF or other external security products through the CMDAUTH macro. RACF uses the resource-name to locate the profile for the command in the OPERCMDS class and verifies that the operator is allowed to issue the command by checking the access list in the profile. If RACF authorizes the access, OnDemand processes the command; if RACF denies the access, OnDemand rejects the command. For detailed information on setting up the OPERCMDS CLASS, see the Administering the Use of Operator Commands section in the Security Server RACF Security Administrator's Guide.

Table 1. RACF commands, access authorities, and resource names
Command/keyword	Authority	Resource-Name
DISPLAY,CONFIG	READ	ARS.DISPLAY.CONFIG
DISPLAY,ENVAR	READ	ARS.DISPLAY.ENVAR
DISPLAY,ICSF	READ	ARS.DISPLAY.ICSF
DISPLAY,OAM	READ	ARS.DISPLAY.OAM
DISPLAY,STATUS	READ	ARS.DISPLAY.STATUS