Commands can be entered either by full name or abbreviation (as given in the parentheses), followed by any appropriate arguments. Arguments appearing in the square brackets [] are optional, and those in curly braces {} indicate a selection from mutually exclusive options.

To let a set of commands be executed together, the administration commands entered are kept in the buffer and performed only when the administrator enters a perform command.

The following commands with their abbreviation and options are described:

clear (cl)

Resets the commands buffer.

config_update (cu) [on|off] (default is on)

Propagates the configuration changes and requests the application servers to take in the changes in the configuration.

help (h) [command]

Without extra argument: prints a list of all the commands.

With a command argument: prints the synopsis of the command.

list (l)

Displays the commands buffer.

If the buffer is empty, the message " WARNING: No command in buffer." is displayed.

newcopy (n) {p|s} object_name 1 object_name2 ...

Enters a new copy command for screen or program object types.

Note:

Do not specify any suffix with object_name when issuing this command. Following is an example for newcopy command.

> newcopy p RSSAT000 RSSAT0001
Newcopy buffered
> p
1:*   newcopy p RSSAT000 RSSAT0001
Perform transmit commands, confirm y/n :y
Perform complete.
>

perform (p)

Performs the commands submitted to the server and clears the commands buffer.

If the buffer is not empty, the buffer container is displayed and a confirmation is required.

If the submission fails, the message " Perform cancelled." is displayed, and the error is logged into the USERLOG

quit (q)

Quits this session.

If the buffer is not empty, the buffer container is displayed and a confirmation is required.

shmstat (sh)

Displays the statistics for GETMAIN SHARED allocated by ARTSHM.

sysid (s) {*:SSSS}

By default, the administration commands are transmitted to all servers in the ART CICS system. The configuration is global. For the newcopy, you may want to limit it to some specific servers. The sysid command is used to limit the command effect to the servers with a specific SYSID.

tspstat (ts) TSMODEL

Shows TS queue statistics information under TSMODEL in shared pool. A sample output for the command is listed as follows:

> tspstat TSM00000
QueName NumItem TRNID TotLen MinLen MaxLen ReadCnt WritCnt ReWrCnt LifeTm ElapTm
------- ------- ----- ------ ------ ------ ------- ------- ------- ------ ------
LOGQHELO 3       HELO   118     56     56     0       3       0       5m    13s
LOGQSTCA 6       STCA   180     16     52     0       6       0       8m    25s

tspdel (td) TSMODEL qname

Deletes TS queue qname in TSMODEL in the shared pool.

tspdsp (tp) TSMODEL qname itemno

Displays item itemno message of TS queue qname in TSMODEL in the shared pool. This command does not change read cursor of the queue. If the message is too large, only part of the message is displayed.

tspclr (tc) poolname

Clears all queues in TS pool poolname.

enqstat (es) [APPLID] [resource_name] [UOW|TASK]

Displays the statistics for ENQ/DEQ resource.

Optional arguments:

APPLID: The APPLID of the resource to be displayed.

resource_name: The name of the resource to be displayed. If resource_name is not specified, all ENQ/DEQ runtime information will be shown.

UOW|TASK: Type, either UOW or TASK.

enqlist (el) [APPLID] [UOW|TASK]

Displays the resource names of ENQ/DEQ.

Optional arguments:

APPLID: The APPLID of the resources to be listed.

UOW|TASK: Type, either UOW or TASK.

enqdel (ed) APPLID resource_name [UOW|TASK]

Delete the specified ENQ resource.

APPLID: The APPLID of the resource to be deleted.

resource_name: The name of the ENQ resource to be deleted.

UOW|TASK: Type, either UOW or TASK.

dynamic_trace (dt) [trace_level(tl)|user_trace(ut)|debug_level(dl)|restore(r)] value

Change the value of trace related environment variable at runtime.

trace_level(tl): trace level specified by TP_TRACE_LEVEL or KIX_TRACE_LEVEL.

user_trace(ut): user trace specified by TP_USER_TRACE or KIX_USER_TRACE.

debug_level(dl): debug level specified by TP_DEBUG_LEVEL or KIX_DEBUG_LEVEL.

restore(r): restore to the original values specified by the corresponding environment variables.