Parameters › OPSPRM and OPSPARM Function › OPSPRM Arguments

OPSPRM Arguments

The OPSPRM function has the following arguments:

parmname

Specifies the name of the CA OPS/MVS parameter (for example, OSFCPU) to be displayed or set. This name can contain no more than 50 characters.

When used to display parameter values (SHOW argument), parmname can be any of the following:

• name-Displays the value of the named parameter or the values of all parameters in the named group.
• GROUPS-Displays a list of the parameter groups.
• ALL-Displays all parameter values.

value

Specifies the new value you are assigning to a parameter. For example, setting value to YES changes the value of the parameter to YES. OPS/REXX requires this argument only when you are setting or resetting parameters.

INFO

(Optional) Use the INFO argument with the SHOW argument to display the possible values the parameter can have.

NAMES

(Optional) Use the NAMES argument with the SHOW argument to display the names and modifiability indicators of individual parameters.

system

(Optional) Provides CA OPS/MVS with the capability to execute the OPSPRM function on external systems that have been defined to the MSF. The MSF establishes VTAM sessions between copies of CA OPS/MVS, permitting any copy to issue a command on any other copy and to receive its response. Specify any of these values for system:

• The name of an individual system on which the function is to execute
• EXT to indicate that the function should execute on all active systems other than the local system
• ALL to indicate that the function should execute on all active systems

As referred to here, active is the status of the MSF systems through which the communication takes place.

Note: A response to the OPSPRM function is returned only if you specify an individual system name for system.

Examples: Invoke OPSPRM

• To display the address of a module, invoke the OPSPRM function as follows:

  RetCode = OPSPRM("SHOW","OPITQWFU")
  Say "OPSPRM() return code is:" RetCode
  Do While Queued() <> 0
   Pull Data
   Say Data
  END
  

  In response, the following information is displayed:

  OPS1000I OPSPRM() return code is:      0
  OPS1000I ADDRESS OF MODULE OPITQWFU X'051AC000'
  

• To display the address of a module with information and name, invoke OPSPRM as follows:

  RetCode = OPSPRM("SHOW","OPITQWFU","INFO","NAMES")
  do while QUEUED() > 0
   pull data
   say data
  end
  

  In response, the following information displays:

  OPS0996I ADDRESS OF MODULE OPITQWFU                      X'0B3AF000'
  OPS0996I OPITQWFU                                        N PRODMODULES
  OPS0996I MODULE ORIGINAL ADDRESS                         X'0B3AF000'
  OPS0996I MODULE FINAL ADDRESS                            X'0B3AF000'
  OPS0996I MODULE VECTOR TABLE ENTRY ADDRESS               X'0979BA30'
  OPS0996I MODULE SIZE                                     6880 BYTES
  OPS0996I MODULE ORIGINAL LOCATION                        EPRIVATE
  OPS0996I MODULE FINAL LOCATION                           EPRIVATE
  OPS0996I MODULE PROTECT KEY                              CODE (2)
  OPS0996I MODULE AMODE                                    31 
  OPS0996I MODULE VERSION                                  rr.rr.sp
  OPS0996I MODULE PROGRAMMER NAME                          OPSASM 
  OPS0996I MODULE ASSEMBLY DATE                            07/21/07
  OPS0996I MODULE ASSEMBLY TIME                            21.50 
  OPS0996I MODULE IS ELIGIBLE FOR RELOAD                   YES 
  

  For MODULE VERSION, rr.rr refers to the release of CA OPS/MVS and sp refers to the service pack number.