0% found this document useful (0 votes)
103 views

CICS Commands Syntax1

This document provides summaries for CICS (Customer Information Control System) EXEC interface commands. It lists over 40 different CICS commands and provides a brief 1-2 sentence description of what each command does. The commands allow programs to perform functions like reading and writing files and queues, communicating with terminals and remote systems, program invocation, memory management, and more.

Uploaded by

Rabindra2416
Copyright
© © All Rights Reserved
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
103 views

CICS Commands Syntax1

This document provides summaries for CICS (Customer Information Control System) EXEC interface commands. It lists over 40 different CICS commands and provides a brief 1-2 sentence description of what each command does. The commands allow programs to perform functions like reading and writing files and queues, communicating with terminals and remote systems, program invocation, memory management, and more.

Uploaded by

Rabindra2416
Copyright
© © All Rights Reserved
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
You are on page 1/ 8

[ ] indicate optional parameters, [ | ] indicates a choice of one of the

options listed (or none), { | } indicates you must specify one of the options.
abend

force the current task to terminate abnormally


EXEC CICS ABEND [ABCODE(name)] [CANCEL] [NODUMP]
END-EXEC.

address

lets you access system information maintained in storage


outside your program
EXEC CICS ADDRESS [ACEE(pointer-ref)]
[COMMAREA(pointer-ref)] [CSA(pointer-ref)] [CWA(pointerref)] [EIB(pointer-ref)] [TCTUA(pointer-ref)] [TWA(pointerref)] END-EXEC.

allocate

establishes a distributed processing session with another


system
EXEC CICS ALLOCATE SYSID(name) [PROFILE(name)]
[NOQUEUE | NOSUSPEND] [STATE(data-area)] END-EXEC.

asktime

obtain current time and date


EXEC CICS ASKTIME [ABSTIME(data-area)] END-EXEC.

assign

obtain information from various system control areas


EXEC CICS ASSIGN option(data-area) END-EXEC.

build attach

creates an ATTACH FMH used to initiate a background


transaction with LU6.1 or MRO
EXEC CICS BUILD ATTACH ATTACHID(name)
[PROCESS(name)] [RESOURCE(name)] [RPROCESS(name)]
[RRESOURCE(name)] [QUEUE(name)] [IUTYPE(data-value)]
[DATASTR(data-value)] [RECFM(data-value)] END-EXEC.

cancel

cancels the effect of a DELAY, POST, or START command


EXEC CICS CANCEL [REQID(name)] [TRANSID(name)]
[SYSID(name)] END-EXEC.

change task

changes the priority of the current task


EXEC CICS CHANGE TASK PRIORITY(data-value) END-EXEC.

connect
process

initiates an application program on a remote system once a


session has been ALLOCATEd
EXEC CICS CONNECT PROCESS {CONV(name) |
SESSION(name) } PROCNAME(data-area) PROCLENGTH(dataarea) SYNCLEVEL(data-area) [PIPLIST(data-area)
PIPLENGTH(data-value)] [STATE(data-area)] END-EXEC.

converse

send data to a remote process and receive a response


EXEC CICS CONVERSE [CONVID(name) | SESSION(name)]
[ATTACHID(name)] FROM(data-area) { FROMLENGTH(dataarea) | FROMFLENGTH(data-area) } { INTO(data-area) |
SET(pointer-ref) } {TOLENGTH(data-area) |
TOFLENGTH(data-area) } [MAXLENGTH(data-value) |
MAXFLENGTH(data-value)] [NOTRUNCATE] [STATE(dataarea)] END-EXEC.

delay

suspend a task
EXEC CICS DELAY [INTERVAL(hhmmss) | TIME(hhmmss) |
FOR [HOURS(hh)] [MINUTES(mm)] [SECONDS(ss)] | UNTIL
[HOURS(hh)] [MINUTES(mm)] [SECONDS(ss)]]
[REQID(name)] END-EXEC.

delete

remove a record from a file


EXEC CICS DELETE { DATASET(name) | FILE(name) }
[RIDFLD(data-area) [KEYLENGTH(data-value) [GENERIC
[NUMREC(data-area)]]]] [RBA | RRN] [SYSID(name)] ENDEXEC.

deleteq td

remove a record from a transient data queue


EXEC CICS DELETEQ TD QUEUE(name) [SYSID(name)] ENDEXEC.

deleteq ts

remove a record from a temporary storage queue


EXEC CICS DELETEQ TS QUEUE(name) [SYSID(name)] ENDEXEC.

deq

release a user defined resource


EXEC CICS DEQ RESOURCE(data-area) [LENGTH(data-value)]
[LUW | TASK | MAXLIFETIME(data-area)] END-EXEC.

dump

force a storage dump


EXEC CICS DUMP [TRANSACTION] DUMPCODE(name)
[FROM(data-area) [LENGTH(data-value) | FLENGTH(datavalue)]] [SEGMENTLIST(data-area) LENGTHLIST(data-area)
NUMSEGMENTS(data-area)] [COMPLETE] [TRT] [TASK]
[STORAGE] [PROGRAM] [TERMINAL] [TABLES] [DCT] [FCT]
[PCT] [PPT] [SIT] [TCT] END-EXEC.

endbr

terminate a browse operation


EXEC CICS ENDBR { DATASET(name) | FILE(name) }
REQID(data-value) [SYSID(name)] END-EXEC.

enq

reserve a user defined resource


EXEC CICS ENQ RESOURCE(data-area) [LENGTH(data-value)]
[NOSUSPEND] [LUW | TASK | MAXLIFETIME(data-area)] END-

EXEC.
enter

write a user trace entry into the CICS trace table


EXEC CICS ENTER {TRACENUM(data-value) | TRACEID(datavalue) } [FROM(data-area) [FROMLENGTH(data-area)]]
[RESOURE(data-area)] [EXCEPTION] END-EXEC.

extract
attach

retrieve values from an ATTACH FMH


EXEC CICS EXTRACT ATTACH [ATTACHID(name) |
CONVID(name) | SESSION(name)] [PROCESS(name)]
[RESOURCE(name)] [RPROCESS(name)]
[RRESOURCE(name)] [QUEUE(name)] [IUTYPE(data-value)]
[DATASTR(data-value)] [RECFM(data-value)] END-EXEC.

formattime

convert time to required format


EXEC CICS FORMATTIME ABSTIME(data-value) [YYDDD(dataarea)] [YYMMDD(data-area)] [YYDDMM(data-area)]
[DDMMYY(data-area)] [MMDDYY(data-area)] [DATE(dataarea) [DATEFORM(data-area)]] [DATESEP[(data-value)]]
[DAYCOUNT(data-area)] [DAYOFWEEK(data-area)]
[DAYOFMONTH(data-area)] [MONTHOFYEAR(data-area)]
[YEAR(data-area)] [TIME(data-area) [TIMESEP[(data-value)]]]
END-EXEC.

free

release a distributed processing session


EXEC CICS FREE [CONVID(name) | SESSION(name)]
[STATE(data-area)] END-EXEC.

freemain

release virtual storage


EXEC CICS FREEMAIN { DATA(data-area) |
DATAPOINTER(pointer-ref) } END-EXEC.

getmain

aquire virtual storage


EXEC CICS GETMAIN SET(pointer-ref) { LENGTH(data-value) |
FLENGTH(data-value) [BELOW] } [INITIMG(data-value)]
[NOSUSPEND] [SHARED] {USERKEY | CICSKEY] END-EXEC.

handle
abend

establish abend exits


EXEC CICS HANDLE ABEND { PROGRAM(name) | LABEL(label)
| CANCEL | RESET } END-EXEC.

handle aid

establish routines to be invoked when AID keys (enter, pf and


pa keys) are detected by a receive map
EXEC CICS HANDLE AID option [(label)] END-EXEC.

handle
condition

specifies how certain exception conditions should be processed


EXEC CICS HANDLE CONDITION condition-name [(label)]
END-EXEC.

ignore
condition

specifies that certain exception conditions should be ignored


EXEC CICS IGNORE CONDITION condition-name ... ENDEXEC.

link

invoke a program, return to the next statement after


completion
EXEC CICS LINK PROGRAM(name) [COMMAREA(data-area)
[LENGTH(data-value)] [DATALENGTH(data-value)]]
[INPUTMSG(data-area) [INPUTMSGLEN(data-value)]]
[SYSID(name)] [SYNCONRETURN] [TRANSID(name)] ENDEXEC.

load

retrieve and load an object module and return its length and
address
EXEC CICS LOAD PROGRAM(name) [SET(pointer-ref)]
[LENGTH(data-area) | FLENGTH(data-area)] [ENTRY(pointerref)] [HOLD] END-EXEC.

pop handle

restores handle abend, aid, and conditions temporarily


suspended by push handle
EXEC CICS POP HANDLE END-EXEC.

post

create a Timer Event Control Area


EXEC CICS POST [INTERVAL(hhmmss) | TIME(hhmmss) |
AFTER [HOURS(hh)] [MINUTES(mm)] [SECONDS(ss)] | AT
[HOURS(hh)] [MINUTES(mm)] [SECONDS(ss)]] SET(pointerref) [REQID(name)] END-EXEC.

purge
message

delete a logical message before the task terminates


EXEC CICS PURGE MESSAGE END-EXEC.

push handle

temporarily suspend handle abend, aid, and conditions


EXEC CICS PUSH HANDLE END-EXEC.

read

read a record from a file


EXEC CICS READ { DATASET(name) | FILE(name) } {
INTO(data-area) | SET(pointer-ref) } [LENGTH(data-area)]
RIDFLD(data-area) [KEYLENGTH(data-area) [GENERIC]]
[SYSID(name)] [RBA | RRN] [GTEQ | EQUAL] [UPDATE] ENDEXEC.

readnext

read the next sequential record from a file


EXEC CICS READNEXT { DATASET(name) | FILE(name) } {
INTO(data-area) | SET(pointer-ref) } [LENGTH(data-area)]
RIDFLD(data-area) [KEYLENGTH(data-area)] [SYSID(name)]
[RBA | RRN] [REQID(data-value)] END-EXEC.

readprev

read the previous sequential record from a file

EXEC CICS READPREV { DATASET(name) | FILE(name) } {


INTO(data-area) | SET(pointer-ref) } [LENGTH(data-area)]
RIDFLD(data-area) [KEYLENGTH(data-area)] [SYSID(name)]
[RBA | RRN] [REQID(data-value)] END-EXEC.
readq td

read a record from a transient data queue


EXEC CICS READQ TD QUEUE(name) { INTO(data-area) |
SET(pointer-ref) } [LENGTH(data-area)] [SYSID(name)]
[NOSUSPEND] END-EXEC.

readq ts

read a record from a temporary storage queue


EXEC CICS READQ TS QUEUE(name) { INTO(data-area) |
SET(pointer-ref) } [LENGTH(data-area)] [NUMITEMS(dataarea)] [ITEM(data-value) | NEXT] [SYSID(name)] END-EXEC.

receive
receive data sent by a remote process
(distributed) EXEC CICS RECEIVE [CONVID(name) | SESSION(name)] {
INTO(data-area) | SET(pointer-ref) } { LENGTH(data-area) |
FLENGTH(data-area) } [MAXLENGTH(data-value) |
MAXFLENGTH(data-value)] [NOTRUNCATE] [STATE(dataarea)] END-EXEC.
receive
(terminal)

retrieve input data from a terminal


EXEC CICS RECEIVE { INTO(data-area) | SET(pointer-ref) } {
LENGTH(data-area) | FLENGTH(data-area) }
[MAXLENGTH(data-value) | MAXFLENGTH(data-value)]
[NOTRUNCATE] [ASIS] [BUFFER] END-EXEC.

receive map

receive data from a terminal via BMS


EXEC CICS RECEIVE MAP(name) [MAPSET(name)]
[INTO(data-area) | SET(pointer-ref)] [ASIS] END-EXEC.

release

free virtual storage acquired via a load command


EXEC CICS RELEASE PROGRAM(name) END-EXEC.

resetbr

re-establish position for a browse


EXEC CICS RESETBR { DATASET(name) | FILE(name) }
RIDFLD(data-area) [KEYLENGTH(data-value) [GENERIC]]
[RBA | RRN] [GTEQ | EQUAL] [REQID(data-value)]
[SYSID(name)] END-EXEC.

retrieve

retrieves data passed to another program via the start


command
EXEC CICS RETRIEVE [INTO(data-area) | SET(pointer-ref)]
[LENGTH(data-area)] [RTRANSID(data-area)] [RTERMID(dataarea)] [QUEUE(data-area)] [WAIT] END-EXEC.

return

return to the invoking program

EXEC CICS RETURN [TRANSID(name) [COMMAREA(data-area)


LENGTH(data-value)]] [IMMEDIATE]] [INPUTMSG(data-area)
[INPUTMSGLEN(data-value)]] END-EXEC.
rewrite

updates a record in a file


EXEC CICS REWRITE { DATASET(name) | FILE(name) }
FROM(data-area) [LENGTH(data-area)] [SYSID(name)] ENDEXEC.

send
send data to a remote process
(distributed) EXEC CICS SEND [CONVID(name) | SESSION(name)]
[ATTACHID(name)] [FROM(data-area) [LENGTH(data-area) |
FLENGTH(data-area)]] [INVITE | LAST] [CONFIRM | WAIT]
[STATE(data-area)] END-EXEC.
send
(terminal)

send data to a terminal


EXEC CICS SEND FROM(data-area) [LENGTH(data-area) |
FLENGTH(data-area)] [DEST(name)] [WAIT] [INVITE | LAST]
[DEFRESP] [STRFIELD] [ERASE] [CTLCHAR(data-area)] ENDEXEC.

send control send device control instructions to a terminal


EXEC CICS SEND CONTROL [ERASEAUP | ERASE] [ALARM]
[FREEKB] [FRSET] [CURSOR(data-value)] [PRINT]
[FORMFEED] [ACCUM] [PAGING | TERMINAL [WAIT] [LAST]]
[L40 | L64 | L80 | HONEOM] [REQID(name)] END-EXEC.
send map

send data to a terminal via BMS


EXEC CICS SEND MAP(name) [MAPSET(name)] [FROM(dataarea)] [LENGTH(data-value)] [DATAONLY | MAPONLY]
[ERASEAUP | ERASE] [ALARM] [FREEKB] [FRSET]
[CURSOR(data-value)] [PRINT] [FORMFEED] [NLEOM]
[ACCUM] [PAGING | TERMINAL [WAIT]] [LAST] [L40 | L64 |
L80 | HONEOM] [REQID(name)] END-EXEC.

send page

write the last page of a BMS message to temporary storage


EXEC CICS SEND PAGE [RELEASE [TRANSID(name)] |
RETAIN] [AUTOPAGE | NOAUTOPAGE] [OPERPURGE]
[TRAILER(data-area)] END-EXEC.

send text

send data to a terminal letting BMS automatically format the


data
EXEC CICS SEND TEXT FROM(data-area) [LENGTH(datavalue)] [ERASE] [ALARM] [FREEKB] [CURSOR(data-value)]
[PRINT] [FORMFEED] [NLEOM] [ACCUM] [PAGING | TERMINAL
[WAIT]] [LAST] [HEADER(data-area)] [TRAILER(data-area)]
[JUSTIFY(datavalue) | JUSFIRST | JUSLAST] [L40 | L64 | L80

| HONEOM] [REQID(name)] END-EXEC.


send text
noedit

send data to a terminal similar to terminal control but can


direct to temporary storage using paging option
EXEC CICS SEND TEXT NOEDIT FROM(data-area)
[LENGTH(data-value)] [ERASE] [ALARM] [FREEKB] [PRINT]
[PAGING | TERMINAL [WAIT] [LAST]] [L40 | L64 | L80 |
HONEOM] [REQID(name)] END-EXEC.

signoff

signs the user off cics


EXEC CICS SIGNOFF END-EXEC.

signon

signs the user on to cics


EXEC CICS SIGNON USERID(datavalue) [PASSWORD(datavalue)] [NEWPASSWORD(data-value)] [OIDCARD(data-value)]
[NATLANG(data-value)] [natlanginuse(data-area)]
[ESMRESP(data-area)] END-EXEC.

start

initiate another task after or at a specified time


EXEC CICS START TRANSID(name) [INTERVAL(hhmmss) |
TIME(hhmmss) | AFTER [HOURS(hh)] [MINUTES(mm)]
[SECONDS(ss)] | AT [HOURS(hh)] [MINUTES(mm)]
[SECONDS(ss)]] [TERMID(name)] [SYSID(name)]
[REQID(name)] [FROM(data-area) [LENGTH(data-value)]]
[RTRANSID(name)] [RTERMID(name)] [QUEUE(name)]
[NOCHECK] [PROTECT] END-EXEC.

startbr

initiate a browse
EXEC CICS STARTBR { DATASET(name) | FILE(name) }
RIDFLD(data-area) [KEYLENGTH(data-area) [GENERIC]]
[SYSID(name)] [RBA | RRN] [GTEQ | EQUAL] [REQID(datavalue)] END-EXEC.

suspend

temporarily return control to cics


EXEC CICS SUSPEND END-EXEC.

syncpoint

rollback or make permanent updates applied to protected


resources
EXEC CICS SYNCPOINT [ROLLBACK] END-EXEC.

unlock

release a record held by a READ UPDATE command


EXEC CICS UNLOCK { DATASET(name) | FILE(name) }
[SYSID(name)] END-EXEC.

wait convid

suspend task until accumulated data has been transmitted


during an APPC conversation
EXEC CICS WAIT CONVID(name) [STATE(data-area)] ENDEXEC.

wait event

delay the task until a previously issued POST has expired


EXEC CICS WAIT EVENT ECADDR(pointer-value) END-EXEC.

write

write a record to a file


EXEC CICS WRITE { DATASET(name) | FILE(name) }
FROM(data-area) [LENGTH(data-area)] RIDFLD(data-area)
[KEYLENGTH(data-area)] [SYSID(name)] [RBA | RRN]
[MASSINSERT] END-EXEC.

write
operator

write a message to a system console


EXEC CICS WRITE OPERATOR TEXT(data-value)
[TEXTLENGTH(data-value)] [ROUTECODES(data-value)
[NUMROUTES)data-value)]] [ACTION(data-value) | EVENTUAL
| IMMEDIATE | CRITICAL | REPLY(data-area)
MAXLENGTH(data-value) [REPLYLENGTH(data-area)]
[TIMEOUT(data-value)]] END-EXEC.

writeq td

write a record to a transient data queue


EXEC CICS WRITEQ TD QUEUE(name) FROM(data-area)
[LENGTH(data-area)] [SYSID(name)] END-EXEC.

writeq ts

write a record to a temporary storage queue


EXEC CICS WRITEQ TS QUEUE(name) FROM(data-area)
[LENGTH(data-area)] [ITEM(data-value) [REWRITE]]
[NUMITEMS(data-area)] [SYSID(name)] [MAIN | AUXILIARY]
[NOSUSPEND] END-EXEC.

xctl

terminate the current program and execute the one specified


EXEC CICS XCTL PROGRAM(name) [COMMAREA(data-area)
[LENGTH(data-value)]] [INPUTMSG(data-area)
[INPUTMSGLEN(data-value)]] END-EXEC.

You might also like