Server Accessory Commands
Use the following commands when running the Server Accessory.
|
|
|
AX BUFFER
|
AX BUFFER [nn]
(main Server Accessory stack only)
Displays or sets the TCP/IP buffer size (see the comments on BUFFER SIZE in the next section)
|
AX HELP
|
To display the AX commands that you can use with the Server Accessory, enter the following command:
mixnumber AX HELP
where mixnumber is the mix number of the Server Accessory.
|
AX QUIT
|
Typically, most sites leave the Server Accessory in the mix. That way, the Server Accessory is available for the DATABridge Clients. If for some reason you want to terminate the Server Accessory, enter the following command:
mixnumber AX QUIT [source]
where mixnumber is the mix number of OBJECT/DATABRIDGE/SERVER, and the optional source is the particular source to be terminated, in which case all Workers using that source will be terminated, or a particular Worker stack. If source is not specified, the Server Accessory terminates after all of the Workers have completed.
If needed, you can terminate individual Worker stacks without terminating the Server Accessory. To do this, enter the following:
mixnumber AX QUIT
where mixnumber is the mix number of a particular Worker stack. The Worker terminates after the next commit.
|
AX SIZES
|
AX SIZES
(Worker stacks only)
Displays various size-related statistics: network read and write, audit record, and transaction group. The number in parentheses is the count of samples of that category. The four numbers at the end of the displayed line are the minimum, maximum, average, and total.
|
AX STATISTICS
|
AX STATISTICS [ TRUE | FALSE ]
(main Server Accessory stack or Worker stacks)
Displays or sets the option enabling or disabling printing the statistics report when a Worker finishes.
If the AX STATISTICS TRUE command is given to the main Server Accessory stack, it affects all sources. If printing is disabled, Workers will not print a statistics report. If printing is enabled, only sources having PRINT STATISTICS = TRUE in the parameter file will have statistics reports. If the command is given to a Worker stack then it determines whether that particular Worker will print the statistics report at EOT, regardless of the PRINT STATISTICS option in the parameter file.
|
AX STATUS
|
You can use the AX STATUS command to display status information for either the main Server Accessory stack or a Worker stack.
|
|
Server stack
|
You can use the AX STATUS command for the main Server Accessory stack to display the transport type, port number, number of offered port subfiles, the Worker limit, the reason it is waiting, and the client host name and source name for each Worker. To do this, enter the following:
mixnumber AX STATUS
where mixnumber is the mix number of the main Server Accessory stack. Once you enter this AX STATUS command, enter SMSG from MARC or MSG from the ODT.
Server Accessory responses appear in the system messages, similar to this:
DBServer: Listening on TCP/IP port 5000 DBServer: Subports offered: 1 DBServer: Workers active: 3, Limit: 10 DBServer: Waiting for new connection or Worker event DBServer:(3) DBHOST accessing BANKDB via TCP/IP port 5000/3 DBServer:(2) DEMOHOST accessing DEMODB via TCP/IP port 5000/2 DBServer:(1) DBHOST accessing CUSTDB via TCP/IP port 5000/1
|
|
Worker stack
|
You can use the AX STATUS command for the Worker stack to display the Client host name, the source name, the transport type, the port number, the audit location, the number of records processed, the size of message segments, and the size of the message buffer. To do this, enter the following:
mixnumber AX STATUS
where mixnumber is the mix number of one of the Server Accessory workers. Once you enter this AX STATUS command, enter SMSG from MARC or MSG from the ODT.
Server Accessory responses appear in the system messages, similar to this:
DBServer:(2) DEMOHOST accessing DEMODB via TCP/IP port 5000/2 DBServer:(2) Protocol level: Client=15 Server=15 DBServer:(2) Port segment size: 4368, Buffer size: 8736 DBServer:(2) AFN=182, ABSN=5845, January 9, 2010 @ 08:41:09 DBServer:(2) Records sent=50, skipped=17, Commits=3 DBServer:(2) Waiting for client request
|
AX TIMES
|
AX TIMES
(Worker stacks only)
Displays various time-related statistics: Network read and write, DBRead wait, thread lock waits, and total processor time. The number in parentheses is the count of samples of that category. The four numbers at the end of the displayed line are the minimum, maximum, average, and total.
|
AX WORKERS
|
The AX WORKERS command allows you to do the following:
|
|