xcicsadm

Top  Previous  Next

xcicsadm performs all the XCICS administrative tasks. It may be employed by system administrators to perform queries on the XCICS status and to control its functionalities, directly from the UNIX/Linux command shell or scripts or from the Windows prompt.

Featured operations:

activity & performance monitoring
resource tables and services reports
shutdown, reload and reconfiguration
terminal status control
file status control
transaction status control
system acquisitions
region tuning
mapset new-copy
URIMAPs control
trace levels and debug control
TCP, HTTP and MQ services control

Resource and service reports

xcicsadm allows the reporting of the following resources and services.

tct

Terminals

pct

Transactions

fct

Files

ppt

Programs

dct

Transient data (destinations)

cct

Connection to remote systems

mps

Mapsets

ushm

User shared memory (GETMAIN)

tcpip

TCP/IP services

tn3270

TN3270 services

mqtrgmon

MQ trigger monitors (CKTI)

proclist

Processes of the region

tpl

Document templates

urm

URIMAPs

Syntax

xcicsadm [options] application_name

Options

-T,--timeout <secs>        

sets the timeout

-s,--stats

shows performances stats

-l,--list <table>

list the specified resources table or services:

tct: terminal control table (by default only active terminals unless -a specified
fct: file control table (datasets)
pct: program control table (transactions)
ppt: program processing table
dct: destination control table (transient data)
mps: mapsets
cct: connection control table
ushm: user shared memory/GETMAIN status
tcpip: TCPIP services
tn3270: TN3270 services
mqtrgmon: MQ trigger monitors
proclist: processes of the region
tpl: document templates table
urm: URIMAPs table

-X,--set-tunable <tunable>=<value>

sets the specified tunable to the provided value. Admittable tunables are:

server_pool_size
max_processes
max_terminals

-a,--all

reports all items of requested table(s) shows contents of shared memory when listing ushm

-x,--extended

reports extended information on requested table, if available. The extended mode is allowed for TCT and URIMAP only

-N,--resolve

resolves IP addresses

-k,--kill <terminal>        

kill specified terminal

-n,--new-copy <mapset>        

performs the new-copy of specified mapset

-e,--enable-transid <transid>

enables specified transid

-d,--disable-transid <transid>

disables specified transid

-o,--open-file <dataset>

opens specified dataset

-c,--close-file <dataset>

closes specified dataset

-t,--trigger <level>

set specified trigger level for selected TD queue (-q)

-q,--td-queue <queue>

specifies TD queue to handle (to use with -t)

-R,--reconfigure

requestes XCICS to reconfigure

-r,--reload

requestes XCICS to reload engine processes

-S,--shutdown

requestes XCICS to shutdown

-i,--immediate

forces an immediate shutdown (with -S)

-A,--acquire <sysid>

acquires connection to specified system

--set-core-trace <level>

sets the core trace level:

none
full

--set-task-trace <level>

sets the task trace level:

none
user
full

--set-debug-display <display>

sets the debugger display for background terminal or transactions. Must be used in conjunction with --transaction or --terminal

--set-debug-display

resets the debugger display for background terminal or transactions. Must be used in conjunction with --transaction or --terminal

--transaction

set specified trace level for specified transaction only (use with --set-task-trace)

--terminal

set specified trace level for specified terminal only (use with --set-task-trace)

--show-trace-info

displays trace/debug data for tct list (use with -l tct)

--tn3270-status

displays the status of tn3270 services (xtnd)

--tn3270-service <name>

restricts operations on specified tn3270 service

--enable-tcpip <name>        

enables the specified tcpip service

--disable-tcpip <name>

disables the specified tcpip service

--enable-tn3270 <name>        

enables the specified tn3270 service

--disable-tn3270 <name>

disables the specified tn3270 service

--enable-mqtrgmon <name>

enables the specified MQ trigger monitor service

--disable-mqtrgmon <name>

disables the specified MQ trigger monitor service

--enable-urimap <name>

enables the specified URIMAP

--disable-urimap <name>

disables the specified URIMAP

--set-synctype-simple <sysid>

sets the syncpoint type to simple for <sysid>

--set-synctype-implied <sysid>

sets the syncpoint type to implied_forget for <sysid>

--set-synctype-explicit<sysid>

sets the syncpoint type to explicit_forget for <sysid>

--cx-file <file>

connects the region qualified by the CX_ <file>

-?,--help

shows help text