Panel | ||||
---|---|---|---|---|
|
...
The command line syntax for each execution of uagcmd must specify a single CLI function, required / optional Global parameters, and required / optional function-specific parameters. You must use the required Global parameters to connect to Command Line Interface (CLI)#OMS OMS Servers and to log on to a Controller (Command Line Interface (CLI)#User User ID and Command Line Interface (CLI)#Password) Password).
(See Command Line Interface (CLI)#Pre Pre-6.2.0.0 CLI Functions for a backward-compatible version of this syntax that can be used for pre-6.2.0.0 CLI functions.)
...
The following command line syntax is used for issuing the CLI command, uagcmd:
...
uagcmd
...
Panel |
---|
...
Command Line Entry
...
Description
uagcmd function Global parameters function-specific parameter(s) |
Command Line Entry | Description |
---|---|
uagcmd | CLI command that executes all CLI functions. |
CLI function that performs a specific action in a Universal Controller. | |
CLI parameters (required and optional) available for all functions. | |
CLI parameters (required and optional) specific to one or more functions. |
For example:
Panel |
---|
uagcmd ops-task-launch -c config.cfg -x encryptedfile.txt task-type=unix task-name=task01 |
In this example, the required Global Parameters are contained in the config.cfg
configuration file.
...
None of these special characters identified in Command Line Interface (CLI)#Special Special Characters Restrictions - =, |, +, and ~ - can be use in a task-variables=
parameter.
...
For all supported platforms, the CLI is included in the Universal Agent 7.12.x package.
UNIX | The CLI functions are installed in the following directory:
Replace | ||||||
---|---|---|---|---|---|---|---|
Windows | The CLI functions are installed in the following directory: Note |
Replace:
| |||||
z/OS | The CLI is implemented with a single program, |
...
- The system level default for CLI access, specified by the System Default Command Line Access Universal Controller system property, has been set to No, and the Command Line Access field in the User Details for your user account is set to -- System Default --."
- The Command Line Access field in the User Details for your user account is set to No, which overrides the System Default Command Line Access value.
If either restriction is in place, the following error message will display when you issue a CLI command:
Panel |
---|
...
User <your user name> not permitted to use the command line interface. Please check with your administrator. |
To remove the restriction, the system administrator must either:
...
Password Expiration
While a password is expired, CLI access will be prohibited until the password has been changed.
...
Parameter | Required | Optional | |||
---|---|---|---|---|---|
Command Line Interface (CLI)#CA CA Certificate List | |||||
Command Line Interface (CLI)#Configuration Configuration File | |||||
Command Line Interface (CLI)#CRL CRL File | |||||
Command Line Interface (CLI)#Encrypted Encrypted File | |||||
Command Line Interface (CLI)#Encrypted Encrypted File Key | |||||
Message Level | |||||
Command Line Interface (CLI)#OMS OMS NFT | |||||
Command Line Interface (CLI)#OMS OMS Servers | |||||
Command Line Interface (CLI)#Queue Queue Name | |||||
SSL/TLS Cipher List | |||||
SSL/TLS Implementation | |||||
SSL/TLS Minimum Protocol Version | |||||
Command Line Interface (CLI)#User User ID | |||||
The following information is provided below for each Global parameter:
...
Description | Configuration file containing one or more Global parameters. It can include the required Command Line Interface (CLI)#User User ID, Command Line Interface (CLI)#Password Password, and Command Line Interface (CLI)#OMS OMS Servers Global parameters.
| ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Platforms | All | ||||||||||
Configuration File Entry | n/a | ||||||||||
Command Line Switch | -c | ||||||||||
Environment Variable | n/a | ||||||||||
Required | No | ||||||||||
Default | (none) | ||||||||||
Example |
|
...
Description | Complete path to a file encrypted with the Universal Encrypt utility that contains encrypted user credentials.
| |||||
---|---|---|---|---|---|---|
Platforms | All | |||||
Configuration File Entry | n/a | |||||
Command Line Switch | -x | |||||
Environment Variable | n/a | |||||
Required | No | |||||
Default | (none) | |||||
Example | UNIX
Windows
z/OS
|
...
Description | Specifies one or more OMS server addresses used for network communication.
If multiple OMS servers are specified, they must be comma-separated. |
---|---|
Platforms | All |
Configuration File Entry | network.omsservers= |
Command Line Switch | -m |
Environment Variable | OMSSERVERS |
Required | Yes |
Default | |
Example | network.omsservers=7878@dallas01.acme.com,7878@dallas02.acme.com |
...
Note | ||
---|---|---|
| ||
If this parameter is specified, all other parameters (except Command Line Interface (CLI)#Help) Help) are ignored. |
Anchor | ||||
---|---|---|---|---|
|
...
The functions and syntax requirements for the z/OS environment are very similar to the other supported platforms with a few exceptions described below.
Command Line Options
...
Note |
---|
IBM’s z/OS Language Environment (LE) interprets the first forward slash (/) in a parameter string as a separator between parameters meant for LE and parameters meant for the program being executed. To avoid confusion, parameters which contain a forward slash should be enclosed in double quotes. For instance agent-type=z/OS should be agent-type=”z/OS”. |
Command Line Options
When UAGCMDZ is executed as a batch program, command line parameters are specified with the step PARM keyword.
For example:
Panel |
---|
...
//STEP01 EXEC PGM=UAGCMDZ,
// PARM='ops-agent-status -c dd:CMDOPTS agent-type=windows' |
Syntax for Options That Accept File Names: -a, -c, -e, and -x
If you use the -a, -c, -e, and -x command line switches for specifying a file on the command line, you must use one of the following formats for the file name.
...
The following example illustrates running UAGCMDZ as a batch job to request the status of all Windows Agents.
Panel |
---|
In this example:
The step PARM value specifies the CLI function and its options.
The job step can include only one function.
The STEPLIB points to the z/OS Agent load library.
The output will be in SYSPRINT.
CMDOPTS is a DDNAME that references the location of the function parameters.
...
You can also issue CLI functions under a TSO session.
The sample command string below shows a CLI function issued from an ISPF Command Shell prompt:
...
This function will return data similar to the sample below:
...
The following two examples show how to issue a CLI function in a batch TSO.
Example One
...
Output will be in SYSTSPRT.
Example Two
...
The following REXX EXEC must be located in USER.REXX(OUTTRAP1):
//jobname JOB (acctg-info),'your name',MSGCLASS=X,MSGLEVEL=(1,1),
// CLASS=A,NOTIFY=&SYSUID
//*
//STEP01 EXEC PGM=UAGCMDZ,
// PARM='ops-agent-status -c dd:CMDOPTS agent-type=windows'
//STEPLIB DD DISP=SHR,DSN=UNV.SUNVLOAD
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//CMDOPTS DD DSN=USER.PARM(CMDOPTS),DISP=SHR
//CEEDUMP DD SYSOUT=* |
In this example:
The step PARM value specifies the CLI function and its options.
The job step can include only one function.
The STEPLIB points to the z/OS Agent load library.
The output will be in SYSPRINT.
CMDOPTS is a DDNAME that references the location of the function parameters.
Anchor | ||||
---|---|---|---|---|
|
You can also issue CLI functions under a TSO session.
The sample command string below shows a CLI function issued from an ISPF Command Shell prompt:
Panel |
---|
Enter TSO or Workstation functions below:
===> uagcmdz ops-agent-status -c "//'USER.PARM(CMDOPTS)'" agent-type=windows |
This function will return data similar to the sample below:
Panel |
---|
Agentname AgentType Status
agent-sys00101 Windows Active
agent-sys00201 Windows Offline
opscmd-complete |
Anchor | ||||
---|---|---|---|---|
|
The following two examples show how to issue a CLI function in a batch TSO.
Example One
Panel |
---|
//CMDZBAT JOB (acctg-info),'your name',MSGCLASS=X,MSGLEVEL=(1,1),
// CLASS=A,NOTIFY=&SYSUID,TIME=5
//*
//STEP01 EXEC PGM=IKJEFT01,DYNAMNBR=200,REGION=40M
//STEPLIB DD DISP=SHR,DSN=UNV.SUNVLOAD
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//SYSTSPRT DD SYSOUT=*
//CMDOPTS DD DSN=USER.PARM(CMDOPTS),DISP=SHR
//SYSTSIN DD *
uagcmdz ops-agent-status -c dd:CMDOPTS agent-type=windows
/* |
Output will be in SYSTSPRT.
Example Two
Panel |
---|
//REXXAGNT JOB (acctg-info),'your name',MSGCLASS=X,MSGLEVEL=(1,1),
// CLASS=A,NOTIFY=&SYSUID,TIME=5
//*
//STEP01 EXEC PGM=IKJEFT01,DYNAMNBR=200,REGION=40M
//STEPLIB DD DISP=SHR,DSN=UNV.SUNVLOAD
//SYSEXEC DD DSN=USER.REXX,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSTSPRT DD SYSOUT=*
//CMDOPTS DD DSN=USER.PARM(CMDOPTS),DISP=SHR
//SYSTSIN DD *
%OUTTRAP1
/* |
The following REXX EXEC must be located in USER.REXX(OUTTRAP1):
Panel |
---|
/**************************** REXX *********************************/
/* Using OUTTRAP to */
/* (1) Obtain z/OS agent status */
/* (2) Test status from the response */
/* (3) Launch a task if the agent status is Active */
/*******************************************************************/
x = OUTTRAP('OPS.')
uagcmdz "ops-agent-status -c dd:CMDOPTS agent-type=""z/OS"""
SAY 'RC is:' RC
SAY OPS.0 'records were read.'
launch = 'NO'
DO i = 1 to OPS.0 WHILE launch = 'NO'
IF SUBSTR(OPS.i,61,6) = 'Active' THEN
DO
launch = 'YES'
uagcmdz "ops-task-launch -c dd:CMDOPTS task-name=DUMPT"
END
END
DO i = 1 to OPS.0
SAY OPS.i
END
y = OUTTRAP('OFF') |