Search:

pages

images

<== Please click on the computer image to visit our home page

Main Home o Site Map o Back o Print o Find on Page o Glossary o FAQ o Web Award o Disclaimer Categories o Browsers o HTML o Stylesheets o Javascript o Interactive Web o Mainframe o PC Software o Networking o Comms Software o Word Processing o Desktop Publishing o Graphics o OS/2 o Linux o DOS/Windows o NT/2000/XP o Book Reviews o Membership Offer o Links Interactive o Alerts o Forum o Guestmap o Newsletter o Tell a Friend o Your Favourites Requests

Ask Felgall Obtain a Quote o PHP Scripts o Package Deals Contact Felgall o Link to Us o Testimonials o Contact Us o About Us

CICS Commands
The following is a list of the common CICS commands and their COBOL syntax. If you are using PL/1 then just substitute ; for END-EXEC. [ ] 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. 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. establishes a distributed processing session with another system EXEC CICS ALLOCATE SYSID(name) [PROFILE(name)] [NOQUEUE | NOSUSPEND] [STATE(data-area)] END-EXEC. obtain current time and date EXEC CICS ASKTIME [ABSTIME(data-area)] END-EXEC. obtain information from various system control areas EXEC CICS ASSIGN option(data-area) END-EXEC. formats alphanumeric data into numeric data EXEC CICS BIF DEEDIT FIELD(data-area) [LENGTH(datavalue)] END-EXEC. 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. cancels the effect of a DELAY, POST, or START command

address

allocate

asktime assign bif deedit

build attach

cancel

EXEC CICS CANCEL [REQID(name)] [TRANSID(name)] [SYSID(name)] END-EXEC. change task connect process changes the priority of the current task EXEC CICS CHANGE TASK PRIORITY(data-value) END-EXEC. 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(data-area) SYNCLEVEL(data-area) [PIPLIST(data-area) PIPLENGTH(data-value)] [STATE(dataarea)] END-EXEC. 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. 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. 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. remove a record from a transient data queue EXEC CICS DELETEQ TD QUEUE(name) [SYSID(name)] ENDEXEC. remove a record from a temporary storage queue EXEC CICS DELETEQ TS QUEUE(name) [SYSID(name)] ENDEXEC. release a user defined resource EXEC CICS DEQ RESOURCE(data-area) [LENGTH(data-value)] [LUW | TASK | MAXLIFETIME(data-area)] END-EXEC. 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]

converse

delay

delete

deleteq td

deleteq ts

deq

dump

[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. reserve a user defined resource EXEC CICS ENQ RESOURCE(data-area) [LENGTH(data-value)] [NOSUSPEND] [LUW | TASK | MAXLIFETIME(data-area)] END-EXEC. 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.

enq

enter

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. extract attributes extract process determine the current state of an MRO or APPC conversation EXEC CICS EXTRACT ATTRIBUTES [CONVID(name) | SESSION(name)] [STATE(data-value)] END-EXEC. used in a back end program to obtain information passed via the CONNECT PROCESS command in the front end program EXEC CICS EXTRACT PROCESS [CONVID(name) | SESSION(name)] [PROCNAME(datavalue)PROCLENGTH(data-area) [MAXPROCLEN(data-value)]] [SYNCLEVEL(data-area)] [PIPLIST(data-area) PIPLENGTH(data-value)] END-EXEC. 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[(datavalue)]]] END-EXEC. release a distributed processing session EXEC CICS FREE [CONVID(name) | SESSION(name)] [STATE(data-area)] END-EXEC. release virtual storage EXEC CICS FREEMAIN { DATA(data-area) |

formattime

free

freemain

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. specifies how certain exception conditions should be processed EXEC CICS HANDLE CONDITION condition-name [(label)] END-EXEC. specifies that certain exception conditions should be ignored EXEC CICS IGNORE CONDITION condition-name ... ENDEXEC. 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. 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(pointer-ref)] [HOLD] END-EXEC. restores handle abend, aid, and conditions temporarily suspended by push handle EXEC CICS POP HANDLE END-EXEC. 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. delete a logical message before the task terminates EXEC CICS PURGE MESSAGE END-EXEC. temporarily suspend handle abend, aid, and conditions EXEC CICS PUSH HANDLE END-EXEC. read a record from a file

handle condition ignore condition link

load

pop handle

post

purge message push handle read

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] END-EXEC. 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. 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. 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. 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)] ENDEXEC. receive data sent by a remote process 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. 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 data from a terminal via BMS EXEC CICS RECEIVE MAP(name) [MAPSET(name)] [INTO(data-area) | SET(pointer-ref)] [ASIS] END-EXEC. free virtual storage acquired via a load command EXEC CICS RELEASE PROGRAM(name) END-EXEC. re-establish position for a browse EXEC CICS RESETBR { DATASET(name) | FILE(name) } RIDFLD(data-area) [KEYLENGTH(data-value) [GENERIC]]

readprev

readq td

readq ts

receive (distributed)

receive (terminal)

receive map

release resetbr

[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(data-area)] [QUEUE(data-area)] [WAIT] ENDEXEC. return to the invoking program EXEC CICS RETURN [TRANSID(name) [COMMAREA(dataarea) LENGTH(data-value)]] [IMMEDIATE]] [INPUTMSG(data-area) [INPUTMSGLEN(data-value)]] ENDEXEC. updates a record in a file EXEC CICS REWRITE { DATASET(name) | FILE(name) } FROM(data-area) [LENGTH(data-area)] [SYSID(name)] ENDEXEC. allows BMS messages to be routed to multiple terminals EXEC CICS ROUTE [LIST(data-area)] [OPCLASS(data-area)] [INTERVAL(hhmmss) | AFTER [HOURS(hh)] [MINUTES(mm)] [SECONDS(ss)] | AT [HOURS(hh)] [MINUTES(mm)] [SECONDS(ss)]] [ERRTERM{(name)]] [TITLE(data-area)] [REQID(name)] [NLEOM] END-EXEC. send data to a remote process 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 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(dataarea)] END-EXEC. 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 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 |

return

rewrite

route

send (distributed)

send (terminal)

send control

send map

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 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)] ENDEXEC. 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. signs the user off cics EXEC CICS SIGNOFF END-EXEC. signs the user on to cics EXEC CICS SIGNON USERID(datavalue) [PASSWORD(datavalue)] [NEWPASSWORD(data-value)] [OIDCARD(datavalue)] [NATLANG(data-value)] [natlanginuse(data-area)] [ESMRESP(data-area)] END-EXEC. 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. 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. temporarily return control to cics EXEC CICS SUSPEND END-EXEC. rollback or make permanent updates applied to protected resources EXEC CICS SYNCPOINT [ROLLBACK] END-EXEC.

send text

send text noedit

signoff signon

start

startbr

suspend syncpoint

unlock

release a record held by a READ UPDATE command EXEC CICS UNLOCK { DATASET(name) | FILE(name) } [SYSID(name)] END-EXEC. suspend task until accumulated data has been transmitted during an APPC conversation EXEC CICS WAIT CONVID(name) [STATE(data-area)] ENDEXEC. delay the task until a previously issued POST has expired EXEC CICS WAIT EVENT ECADDR(pointer-value) END-EXEC. synchronizes the current task with a previously written journal entry by suspending the task until the record has been successfully written to the journal file EXEC CICS WAIT JOURNALNUM(data-value) [REQID(datavalue)] [STARTIO] END-EXEC. 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 a record to the journal file EXEC CICS WRITE JOURNALNUM(data-value) JTYPEID(datavalue) FROM(data-area) [LENGTH(data-area)] [PREFIX(data-value) [PFXLENG(data-value)]] [REQID(dataarea)] [WAIT] [STARTIO] [NOSUSPEND] END-EXEC.

wait convid

wait event wait journalnum

write

write journalnum

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. 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. 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.

writeq ts

xctl

FaceBook Follow Twitter Follow

Add to del.icio.us Computers and PC Hardware Ask Felgall Member's Area User Name: Email:
Join Now - Free

Computer Help Blog

Search

Contact Us Guestmap Copyright 2000 - 2011 Felgall Pty Ltd

ICRA - Rating Labels - SafeSurf

Copyright Felgall Pty Ltd

Web Hosting | VPS Hosting | Dedicated Hosting