Other

xstart

The xstart utility is used to start transactions on XCICS from script shell.

Syntax

xstart [-s][-h][-t<termid>][-a<applid>] [<transid>]

If no transid is specified input is taken from standard input.

When passing iput from standard input additional data may be specified.

Options

-s	silent mode
-t <termid>	task is started on specified termid (must be defined as virtual)
-a <applid>	specifies application name
-v	verbose mode is turned on

Example

# xstart -a TESTCICS ATR0
# xstart -a TESTCICS
ATR0 DATA FOR RETRIEVE
#

xqio

The xqio utility is used to upload/download data to/from temporary storage.

Syntax

xqio [options] (get|put)

Commands

get download specified file from XCICS temporary storage

put upload specified file to XCICS temporary storage

Options

-v	verbose mode
-a	interacts with specified
-t	use specified temporary storage
-T	run loading on specified virtual terminal
-l	specifies temporary storage record length
-s	script name to be activated when download is completed
-P	program name to be linked after when upload is completed
-i	forces XCICS to use a temporary storage named CFTR

Transaction

xqio is backed up by an XCICS transaction called XQIO.

To configure it add the following lines to the xcics.conf:

define program name=xqio;
define transaction code=XQIO, program=xqio, twa=512, protection=64;

Called program

XQIO may link a use program. This program is linked passing a commarea as follow:

01 COMMAREA.
02 FILLER PICTURE XX.
02 FILLER PICTURE XX.
02 CFTR-FILE PICTURE X(8).
02 CFTR-QUEUE.
03 CFTR-NAME PICTURE X(4).
03 CFTR-TERM PICTURE X(4).
02 RET-CODE PICTURE X(2).
02 FILLER PICTURE X(6).
CFTR-QUEUE contains the TS name.

RET-CODE contains the return code passed back by linked program. If user program returns "DL" the TS is rewritten to the file.

Example

# xqio -a TESTCICS -l 100 put $HOME/file01.dat
# xqio -a TESTCICS -t A0L0AHBH -l 80 get $PWD/ts01.txt