Apuntes de Sentencias de Cics

[RESUMEN DE
ELEMENTOS DE
CICS]
Sintaxis de sentencias por temas, cdigos de error, macros de mapas
[RESUMEN DE ELEMENTOS DE CICS]
Tablas del CICS.................................................................................................... 7

reas de comunicacin para pasar datos de un programa a otro.......................7
LINK........................................................................................................... 7
XCTL.......................................................................................................... 7
RETURN..................................................................................................... 8
ABEND....................................................................................................... 8
Comunicaciones con el mapa............................................................................. 8
SEND......................................................................................................... 8
RECEIVE..................................................................................................... 9
SEND TEXT................................................................................................. 9
Sentencias de obtencin de la fecha y hora.......................................................9
ASKTIME..................................................................................................... 9
FORMATTIME.............................................................................................. 9
Operaciones con ficheros.................................................................................. 10
READ....................................................................................................... 10
UNLOCK................................................................................................... 11
WRITE...................................................................................................... 11
TOKEN..................................................................................................... 11
SENTENCIAS DE ACTUALIZACIN DE ARCHIVOS............................................12
REWRITE.................................................................................................. 12
DELETE.................................................................................................... 12
Temporary Storage............................................................................................ 12
WRITEQ TS............................................................................................... 12
READQ TS................................................................................................ 13
DELETEQ TS............................................................................................. 13
Revisin de un archivo: Browse.........................................................................13
STARTBR.................................................................................................. 13
RESETBR.................................................................................................. 13
READPREV............................................................................................... 14
READNEXT............................................................................................... 14
ENDBR..................................................................................................... 14

Interface de Programacin de Alto Nivel (HLPI).................................................15
EIB................................................................................................................. 15
EIBAID............................................................................................................ 17
Basic Mapping Support (BMS)...........................................................................18
Macros para la generacin de Mapas.............................................................18
DFHMSD.................................................................................................. 18
DFHMDI.................................................................................................... 19
DFHMDF................................................................................................... 20
Accesar a las areas de cics............................................................................... 23
ADDRESS................................................................................................. 24
Cdigos de excepciones.................................................................................... 24
Cdigos de retorno en EIBRESP.........................................................................26
NORMAL................................................................................................... 26
ERROR..................................................................................................... 26
RDATT...................................................................................................... 26
WRBRK.................................................................................................... 26
EOF.......................................................................................................... 27
EODS....................................................................................................... 27
EOC.......................................................................................................... 27
INBFMH.................................................................................................... 27
ENDINPT.................................................................................................. 27
NONVAL................................................................................................... 27
NOSTART.................................................................................................. 27
TERMIDERR.............................................................................................. 27
FILENOTFOUND........................................................................................ 27
NOTFND................................................................................................... 27
DUPREC................................................................................................... 27
DUPKEY.................................................................................................... 27
INVREQ.................................................................................................... 27
IOERR...................................................................................................... 27
NOSPACE................................................................................................. 27
NOTOPEN................................................................................................. 27
ENDFILE................................................................................................... 27

ILLOGIC.................................................................................................... 27
LENGERR................................................................................................. 27
QZERO..................................................................................................... 27
SIGNAL..................................................................................................... 27
QBUSY..................................................................................................... 27
ITEMERR.................................................................................................. 27
PGMIDERR............................................................................................... 27
TRANSIDERR............................................................................................ 27
ENDDATA................................................................................................. 27
INVTSREQ................................................................................................ 27
EXPIRED................................................................................................... 27
RETPAGE.................................................................................................. 27
RTEFAIL.................................................................................................... 27
RTESOME................................................................................................. 27
TSIOERR................................................................................................... 27
MAPFAIL................................................................................................... 27
INVERRTERM............................................................................................ 27
INVMPSZ.................................................................................................. 27
IGREQID................................................................................................... 27
OVERFLOW.............................................................................................. 27
INVLDC.................................................................................................... 27
NOSTG..................................................................................................... 27
JIDERR...................................................................................................... 27
QIDERR.................................................................................................... 27
NOJBUFSP................................................................................................ 27
DSSTAT.................................................................................................... 27
SELNERR.................................................................................................. 27
FUNCERR................................................................................................. 27
UNEXPIN.................................................................................................. 27
NOPASSBKRD........................................................................................... 27
NOPASSBKWR.......................................................................................... 27
SYSIDERR................................................................................................. 27
ISCINVREQ............................................................................................... 28

ENQBUSY................................................................................................. 28
ENVDEFERR............................................................................................. 28
IGREQCD.................................................................................................. 28
SESSIONERR............................................................................................ 28
SYSBUSY.................................................................................................. 28
SESSBUSY................................................................................................ 28
NOTALLOC............................................................................................... 28
CBIDERR.................................................................................................. 28
INVEXITREQ............................................................................................. 28
INVPARTNSET........................................................................................... 28
INVPARTN................................................................................................. 28
PARTNFAIL................................................................................................ 28
USERIDERR.............................................................................................. 28
NOTAUTH................................................................................................. 28
SUPPRESSED............................................................................................ 28
TERMERR................................................................................................. 28
ROLLEDBACK........................................................................................... 28
DISABLED................................................................................................ 28
OPENERR................................................................................................. 28
LOADING.................................................................................................. 28
Recomendaciones de formateo de pantallas....................................................28
Reglas para color y posicin de los campos:..................................................28
Reglas para asignar funcin de teclas:..........................................................28
Formato y contenido del byte de atributo......................................................29
Contenido del byte atributo.....................................................................29
Atributos extendidos................................................................................ 30
Modificar los atributos al byte atributo..........................................................30
Modificacin a los atributos de pantalla:.................................................30
Subfijos de los campos de atributo..........................................................31
Procedimiento de jcl para ensamblar el mapa...............................................32
Transacciones de servicio.................................................................................. 32
CESN: The signo n transaction................................................................33
CESF: The sign off transaction................................................................33

CEMT: The master terminal transaction...................................................33
CECI: Interprete de comandos................................................................33
Otros comandos de CICS................................................................................... 33
Comando para el uso del Intervalo de control del CICS.................................34
START....................................................................................................... 34
RETRIEVE................................................................................................. 35
CANCEL.................................................................................................... 36
Comandos para el uso del control de tareas de CICS.....................................36
SUSPEND................................................................................................. 36
ENQ y DEQ............................................................................................... 36
Comandos para el uso del control de almacenamiento de CICS....................37
GETMAIN.................................................................................................. 37
Comandos para el uso del proceso de recuperamiento (journal control).......38
SYNCPOINT.............................................................................................. 38
Control de versiones del documento.................................................................39
Tablas del CICS

La TABLA PCT (Program Control Table) para el nombre de la Transaccin y su asociacin con el
programa.
La TABLA PPT (Program Process Table) para el nombre del programa asociado con la transaccin.
La TABLA FCT (File Control TABLE) para los nombres de los archivos que usara la transaccin.
reas de comunicacin para pasar datos de un

programa a otro
DATA DIVISION.
WORKING-STORAGE SECTION.
O1 WCA-COMMAREA.
.
LINKAGE SECTION.
01 DFHCOMMAREA PIC X(200).
Declaracin en COBOL para accede a los datos.
PROCEDURE DIVISION.
LLAMAR AUN PROGRAMA EN CICS

LINK el programa llamado se localiza a un nivel Lgico inferior
EXEC CICS LINK
PROGRAM (nombre del programa)
COMMAREA (WCA-COMMAREA) mandar datos
END-EXEC
XCTL Transfiere el control a un programa del mismo nivel lgico.

XCTL
PROGRAM
(Nombre del Programa )
COMMAREA (Nombre del rea de comunicacin)
LENGTH
(Longitud del rea de comunicacin)
El error ms comn en la transferencia es:

EIBRESP = 27
(PGMIDERR)

Ocurre en alguna de las siguientes situaciones:
El programa no esta declarado en la PPT (EIBRESP2=1).
El programa esta deshabilitado (EIBRESP2=2).
El programa no se puede cargar (EIBRESP2=3).
La definicin del programa es para un programa remoto (EIBRESP2=9).
RETURN Regresar el control
RETURN
[TRANSID
(Nombre de la transaccin )]
[
COMMAREA (Nombre del rea de comunicacin)]
[
LENGTH
(Longitud del rea de comunicacin)]
El rea de comunicaciones indicada en COMMAREA debe estar declarada en la

LINKAGE SECTION su nombre debe ser DFHCOMMAREA y se utiliza como medio
de comunicacin entre las Transacciones.
ABEND Transfiere el control a una rutina abend o regresa el control a CICS.
ABEND [ABCODE(abend-code)]
[NODUMP]
Comunicaciones con el mapa

SEND Enva datos al mapa
SEND
MAP
(Nombre de MAPA)
MAPSET
(Nombre del MAPSET)
[FROM
(Nombre de rea) ]
[LENGTH
(Dato numrico) ]
[CURSOR
(Posicin del cursor)] de 1 a 1920
[ERASE | ERASEAUP]
[MAPONLY | DATAONLY]
[ALARM]
ERASE indica que se debe borrar el BUFFER de pantalla antes de que se

exhiban los datos.

RECEIVE Recibe datos del mapa
RECEIVE
MAP
MAPSET
INTO
(Nombre de MAPA)
(Nombre del MAPSET)
(rea de datos)
En caso de un error en la recepcin del mapa, se genera el cdigo 36 (MAPFAIL)

en EIBRESP
SEND TEXT Comando para enviar un mensaje a la terminal sin crear un BMS
mapset.
SEND TEXT FROM(data-name)
[ERASE]
[FREEKB]
Sentencias de obtencin de la fecha y hora

ASKTIME Obtiene el timestamp del sistema en entero sin formato.
ASKTIME
[ABSTIME (rea de datos)] WF-ABSTIME ( PIC S9(15) COMP-3. )
FORMATTIME
Da formato a la fecha y hora obtenida por ASKTIME
FORMATTIME
ABSTIME
(rea de datos con la fecha en forma numrica)
[DATE(data-name)]
[FULLDATE(data-name)]
DATESEP
(Separador de fecha)
TIMESEP
(Separador de hora)
Formato de la fecha (rea para fecha) WX-DATE (PIC X(8) )
TIME
(rea para la hora)
WX-HORA (PIC X(8) )
Ejemplo:
EXEC CICS FORMATTIME
ABSTIME (WF-ABSTIME)
DATESEP ('/')
TIMESEP (':')
YYDDD
YYMMDD

DDMMYY (WX-DATE) <- el formato de fecha
TIME
(WX-HORAS)
END-EXEC
YYDDMM
DDMMYY
MMDDYY
Variantes del formato de fecha
Operaciones con ficheros

READ Lectura de un archivo VSAM
READ
FILE
(Nombre de archivo)
INTO
(Nombre de rea)
[LENGTH
(Longitud del rea de datos)]
RIDFLD
(rea de la clave)
[GENERIC]
[RRN | RBA]
[KEYLENGTH (Longitud del rea de clave)]
[GTEQ | EQUAL]
[RESP(RESPONSE-CODE)]
[UPDATE]
Si se utiliza la opcin UPDATE, se localiza un registro para posteriormente

borrarlo (Ver DELETE) o para modificarlo (Ver REWRITE).
En caso de no localizar el registro solicitado, el EIBRESP contiene el valor 13
(NOTFND)

UNLOCK
Si realizas una operacin de READ con la opcin UPDATE, y se detecta que nos
es necesario actualizar o borrar el registro; podemos desbloquear el registro
con el comando UNLOCK.
UNLOCK FILE(filename)
WRITE Escritura de un archivo VSAM

WRITE
FILE
(Nombre de archivo)
FROM
(Nombre de rea)
[LENGTH
RIDFLD
(rea de la clave)
MASSINSERT
[KEYLENGTH (Longitud del rea de clave)]
[RRN | RBA]
En caso de que la clave de acceso en RIDFLD ya exista en el archivo (CLAVE

DUPLICADA); el EIBRESP contiene el valor 14 (DUPREC)
TOKEN
Se utiliza para hacer ms de una actualizacin a registros:
SENTENCIAS DE ACTUALIZACIN DE ARCHIVOS

REWRITE Si se especfica la clausula UPDATE en read, se puede reescribir un
determinado registro.
REWRITE
FILE
FROM
[LENGTH
(Nombre de archivo)
(rea de datos)
(Dato numrico)]
DELETE Si se especfica la clausula UPDATE en read, se puede borrar un determinado

registro.
DELETE
FILE
RIDFLD
[KEYLENGTH
[RRN | RBA]
[GENERIC
(Nombre de archivo)
(rea de datos)
(Dato numrico)]
[ NUMREC (rea de datos)] ]
Se puede eliminar un grupo de registros con un solo comando DELETE,

identificando el grupo con la opcin GENERIC.
En caso de usar GENERIC, el CICS devuelve el nmero de registros borrados en
la variable indicada en NUMREC.
Existe una forma diferente de este comando; para borrar un registro que
previamente se ha ledo para modificarlo con el comando READ UPDATE. Pero
en este caso, el registro no se reescribe, sino que se borra, en este caso no se
especifica la opcin RIDFLD
Temporary Storage
WRITEQ TS
WRITEQ TS
QUEUE
(Nombre de cola) 4 caracteres mx.
FROM
(Nombre de rea)
[LENGTH
[ITEM
(Area Numrica) REWRITE] PIC S9(04) COMP-3
[NUMITEMS(data-name)]
[MAIN | AUXILARY]
WRITEQ TS Aade un nuevo registro a la cola. Si la cola no existe, se crea

una con el nombre indicado y se escribe el primer registro. Si se usa la opcin

REWRITE, no se aade un nuevo registro, sino que se reescribe el registro
indicado en ITEM.
El rea numrica (PIC S9(04) COMP-3) en ITEM, devuelve el numero de registro
(tem) que se grabo en la cola. Si se usa REWRITE, en la variable de ITEM se
pone el nmero del tem que se va a modificar.
READQ TS
Lee un elemento de la cola.
READQ TS
QUEUE
(Nombre de cola)
INTO
(Nombre de rea)
[LENGTH
[ITEM
(data-name | literal) | NEXT]
[NUMITEMS(data-name)]
Si el numero de tem no se localiza en la cola, se genera el cdigo 26

(ITEMERR) en la variable EIBRESP.
DELETEQ TS
Borrar una cola
DELETEQ TS
{QUEUE | QNAME}
(Nombre de Cola)
El cdigo 44 (QIDERR) corresponde a un error en el nombre de la cola, es

decir, se equivoco con el nombre de la cola.
Revisin de un archivo: Browse

STARTBR Inicia el Browse en un determinado registro.
STARTBR
FILE
(Nombre del archivo)
RIDFLD
(Nombre del rea de clave)
[REQID
(Numero de la revisin) ]
[RRN | RBA]
[GTEQ | EQUAL]
[GENERIC]
KEYLENGTH (Longitud del rea de clave)

RESETBR
Para reiniciar el browse a una nueva posicin.
RESETBR
FILE
RIDFLD
(Nombre del rea de clave)
[RRN | RBA]
[GTEQ | EQUAL]
[GENERIC]
KEYLENGTH (Longitud del rea de clave)
READPREV Lee un registro anterior

READPREV
FILE
INTO
(Area de datos)
LENGTH (Longitud de datos)
RIDFLD (Area de clave)
KEYLENGTH (Long. de clave)
[REQID
(Numero de la revisin)
READNEXT Lee el siguiente registro

READNEXT
FILE
INTO
(Area de datos)
LENGTH (Longitud de datos)
RIDFLD (Area de clave)
KEYLENGTH (Long. de clave)
[REQID
(Numero de la revisin)
ENDBR Finaliza el browse

ENDBR
FILE
[REQID
(Nombre de archivo)
(Nombre de rea) ]
El valor REQID es un identificador (S9(04) COMP-3) numrico que se usa para

identificar diferentes solicitudes de BROWSE. Si se omite REQID, el valor por
default es Cero.
El cdigo de error 16 (INVREQ) corresponde al caso de una revisin no iniciada.
Interface de Programacin de Alto Nivel (HLPI)

Esta interface est compuesta de un conjunto de mandatos que se insertan
en los programas COBOL cuando se necesita una funcin del CICS.
EIB
EIBAID
Guarda la tecla de control utilizada para transmitir la ltima entrada de datos
por pantalla. La definicin de las teclas de control se realiza con la copy
DFHAID. La lista estndar de dichas teclas es la siguiente.
01DFHAID.
02DFHNULLPICXVALUEIS''.
02DFHENTERPICXVALUEIS''''.
02DFHCLEARPICXVALUEIS'_'.
02DFHCLRPPICXVALUEIS'('.
02DFHPENPICXVALUEIS'='.
02DFHOPIDPICXVALUEIS'W'.
02DFHMSREPICXVALUEIS'X'.
02DFHSTRFPICXVALUEIS'h'.
02DFHTRIGPICXVALUEIS'''.
02DFHPA1PICXVALUEIS'%'.
02DFHPA2PICXVALUEIS''.
02DFHPA3PICXVALUEIS','.
02DFHPF1PICXVALUEIS'1'.
02DFHPF10PICXVALUEIS':'.
02DFHPF11PICXVALUEIS'#'.
02DFHPF12PICXVALUEIS'@'.
Basic Mapping Support (BMS)
Fsico
Define y da nombre a los campos Mapa
que se
pueden escribir o recibir, desde lo
Mapacon el que est asociado. Suministra

Es generado con las mismas macros que el Mapa Fsico
Simblico
Es generado al compilar el mapa fsico por el compilador

de mapas.
Lgico
Macros para la generacin de Mapas

DFHMSD
Nombre de mapset DFHMSD
TYPE=Tipo,MODE=Modo,LANG=COBOL,STORAGE=AUTO,
TIOAFPX=YES,CTRL=(Control1,Control2),
MAPATTS=(COLOR,HILIGHT), DSATTS(COLOR,HILIGHT)
Un MAPSET puede contener varios mapas y al ensamblarse, se generan varios

MAPAS SIMBOLICOS, Uno por cada mapa declarado, aunque en nuestro caso,
nuestro MAPSET contiene un solo mapa.
TYPE=tipo
TYPE gobierna el resultado del proceso de ensamble, que produce un mapa
fisico o un mapa simblico segn el tipo indicado, primero se ensambla con
TYPE=MAP, y se produce un mapa fisico que CICS usa en el proceso, despus se
ensambla con TYPE=DSECT, y se produce un mapa simblico en lenguaje COBOL
que se almacena en la biblioteca de COPY para incluirlo en el programa de
aplicacin con una orden COPY.
MODE=modo
El modo indica si el mapa se usara nicamente para entrada MODE=IN,
nicamente para salida MODE=OUT, o para ambas MODE=INOUT.
LANG=COBOL
Indica el lenguaje de la estructura del mapa simblico (DSECT Structure) que se
copiara en el programa de aplicacin, en este caso, COBOL.
STORAGE=AUTO
Se usa para impedir que las definiciones del mapa simblico se encimen una
sobre otra con redefiniciones del primer mapa, si se van a usar varios mapas al
mismo tiempo dentro de un programa de aplicacin, se omite STORAGE=AUTO.

CTRL=(Control1,Control2,...)
Este parmetro tiene el mismo significado que en la macro DFHMDI, la diferencia
es que si se pone en la DFHMSD afecta a todos los mapas del Mapset que no
tengan CTRL en su propia DFHMDI.
TIOAPFX=YES
Este parmetro se usa siempre en programas, y genera los doce primeros
caracteres de control del mapa simblico.
DFHMSD TYPE=FINAL
END
Para terminar la definicin de un MAPSET, se usa DFHMSD seguida de la instruccin de
ensamblador END.
DFHMDI
Nombre de Mapa DFHMDI
SIZE=(Renglon,Columna),
-
LINE=n,
COLUMN
n,
CTRL=(Control1,Control2...)
SIZE=(Renglon,Columna)
Este parmetro indica el tamao del mapa, el BMS permite que una pantalla
pueda estar formada de varios mapas, y cada mapa puede ser de diferente
tamao, en este caso el mapa es del tamao de la pantalla estndar (24
Renglones, 80 columnas).
LINE= Lnea en la que comenzar el mapa.
COLUMN= Dimensin del mapa en longitud y anchura.
CTRL=(Control1,Control2,...)
Este es el parmetro de control de la pantalla y el teclado que se va a enviar
junto con los datos del mapa, puede ser cualquier combinacin de lo siguientes:
PRINT
Especifica que el mapa puede enviarse a una impresora, esto es, si se piensa que
es necesario enviar los datos para impresin, se usa PRINT.
FREEKB
(Libera el teclado). El teclado se bloquea automticamente tan pronto como el

usuario enva datos al procesador, permanece bloqueado hasta que alguna

transaccin lo libera o hasta que el usuario oprime la tecla <RESET>.
Generalmente se especifica FREEKB para mantener liberado el teclado.
ALARM
Este parmetro hace que suene la alarma audible de la terminal.(Este parmetro
solo funciona en caso de que la terminal tenga alarma audible, en otro caso, se
ignora).
FRSET
Coloca todos los bits de modificacin de cada atributo de cada campo en ceros,
indicando no modificacin.
NOTA: El nombre del campo no debe de rebasar los 7 caracteres .
DFHMDF
Nombre de Campo DFHMDF POS=(Renglon,columna),LENGTH=nmero,
(long + 1
ctrl)
-INITIAL=texto,OCCURSS=(numero),
-ATTRB=(atributo1,
atributo2,...),
COLOR=color,
-HILIGHT=REVERSE,
PICIN=999V99,
PICOUT =ZZZ,ZZ9.99.,
GRPNAME=data-name
NOTA: El nombre del campo no debe de rebasar los 7 caracteres.

Si los datos no caben en un rengln, se debe usar un carcter de continuacin en la
columna 72, cualquier carcter es valido, excepto espacio y l ultimo del rengln.
POS
Define la posicin donde se posiciona el campo.
LENGTH
Longitud del campo + 1 byte del carcter de control.
INITIAL
Etiqueta inicial.
ATTRB
Estos son los atributos del campo.
Hay varias caractersticas diferentes que se pueden especificar:
La primera caracterstica es la INTENSIDAD, las opciones son:
NORM
El campo se exhibe con intensidad Normal.
BRT
El campo se exhibe con intensidad Brillante.
DRK
El campo se exhibe obscuro (no se ve)
La segunda caracterstica controla lo que el usuario puede hacer desde el teclado, las opciones
son:
ASKIP
No se puede teclear en el campo, y si el campo anterior esta lleno, el

cursor brinca sobre este campo, pasando al siguiente disponible.
PROT
No se puede teclear en el campo, pero el cursor no brinca sobre este

campo si el anterior esta lleno. Se usa en situaciones de creacin de
stopper.
UNPROT
NUM
Si se pueden teclear datos dentro del campo.

Si se pueden teclear datos dentro del campo, pero solo se aceptan
nmeros, el signo de menos, y el punto decimal.
La tercera caracterstica controla la etiqueta de Datos modificados. Si un dato cambia en la

pantalla, queda listo para enviarse al programa, si no cambia; no se enva. La opcin es:
FSET
Activa la etiqueta de Datos Modificados. Esto provoca que el campo se

enve al programa aunque no se haya modificado. Si no se especifica
FSET, entonces el campo se enva al programa solamente cuando el
usuario lo modifique.
La Cuarta caracterstica, que se especifica como parte de los atributos, indica que este es el
campo donde se posicionara el cursor. La opcin es:
IC
Pone el cursor en la primera posicin del campo, un solo campo es el que

puede tener el cursor, por lo tanto, si se pone IC en varios campos, el
cursor se posicionara en el ultimo.
Si no se especifica el parmetro ATTRIB, entonces el campo tendr caractersticas

ASKIP, NORM, por default, no tendr FSET ni IC.
COLOR=color

Indica cual ser el color de los caracteres del campo, las opciones son:
WHITE
Color blanco
BLUE
Color azul
RED
Color rojo
PINK
Color rosa
GREEN
Color verde
TURQUOISE
Color turquesa
YELLOW
Color amarillo
NEUTRAL
La opcin HILIGTH=REVERSE se puede usar con terminales que no tengan color.Usando esta
opcin, se puede destacar un campo, invirtiendo el display de letras claras sobre fondo obscuro
convirtindolo a letras obscuras sobre fondo claro
PICIN Define el formato para los datos de entrada al programa.
PICOUT Define el formato de los datos para la salida del programa
GRPNAME Se especifica si se quiere que determinados campos se agrupen, las variables para
un mismo grupo, se deben de codificar en secuencial.
Ejemplo de mapa completo
PRINT NOGEN
*------------------------* DESCRIPCION DEL MAPSET
*------------------------BE00MS
DFHMSD TYPE=&SYSPARM,MODE=INOUT,LANG=COBOL,TERM=3270,
STORAGE=AUTO,CTRL=(FREEKB,FRSET),TIOAPFX=YES,EXTATT=YES
*---------------------* DESCRIPCION DEL MAPA
*---------------------BE00M01 DFHMDI LINE=01,COLUMN=01,SIZE=(24,80)
*-----------------------------------* DESCRIPCION DE LOS CAMPOS DEL MAPA
*-----------------------------------DFHMDF POS=(01,30),LENGTH=17,ATTRB=ASKIP,
COLOR=WHITE,
HILIGHT=REVERSE,
INITIAL='MENU DE OPCIONES'
DFHMDF POS=(01,48),LENGTH=01,ATTRB=ASKIP
DFHMDF POS=(02,01),LENGTH=08,ATTRB=ASKIP,
COLOR=YELLOW,

INITIAL='FECHA : '
COLOR=WHITE
COLOR=YELLOW,
INITIAL='HORA : '
HORA
DFHMDF POS=(02,70),LENGTH=08,ATTRB=ASKIP,COLOR=WHITE
DFHMDF POS=(05,25),LENGTH=12,ATTRB=ASKIP,COLOR=TURQUOISE
INITIAL='<1> CONSULTA'
COLOR=TURQUOISE,
INITIAL='<2> BAJA'
COLOR=TURQUOISE,
INITIAL='<3> ALTA'
COLOR=TURQUOISE,
INITIAL='4. CAMBIO'
DFHMDF POS=(10,30),LENGTH=06,ATTRB=ASKIP,COLOR=GREEN,
INITIAL='OPCION '
OPCION
DFHMDF POS=(10,37),LENGTH=01,ATTRB=(IC,NUM,FSET)
DFHMDF POS=(12,05),LENGTH=11,ATTRB=ASKIP,COLOR=GREEN,
INITIAL='<Esc> Terminar
<Enter> Acepta Opcin '
* TERMINA DESCRIPCION DEL MAPSET
DFHMSD TYPE=FINAL
END
FECHA
Accesar a las areas de cics

Cuando se require de otras areas de cics para pasar datos como
DFHCOMMARE, se tienen las siguientes areas de memoria a las que se les debe
de dar direccionamiento mediante el comando ADDRESS.
CWA (Common Area Work)

TWA(Transaction Work Area)
TCTUA(Terminal Control Table User Area)
ADDRESS
[CWA(POINTER)]
[TWA(POINTER)]
[TCTUA(POINTER)]
Cdigos de excepciones
Cdigos de retorno en EIBRESP

Se reciben en un campo numrico PIC S9(08) COMP.
N
00
01
02
03
04
05
CONDITION
NORMAL
ERROR
RDATT
WRBRK
EOF
EODS
DESCRIPCION
Ejecucin correcta de la operacin
Error sin clasificacin.
El operador oprimi tecla ATTN en lugar de RETURN o RECEIVE
Operador Interrumpi SEND MAP oprimiendo tecla ATTN .
En RECEIVE y terminal 3735 fin archivo.
En RECEIVE MAP no se reciben datos.

06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
53
54
55
EOC
INBFMH
ENDINPT
NONVAL
NOSTART
TERMIDERR
FILENOTFOUND
NOTFND
DUPREC
DUPKEY
INVREQ
IOERR
NOSPACE
NOTOPEN
ENDFILE
ILLOGIC
LENGERR
QZERO
SIGNAL
QBUSY
ITEMERR
PGMIDERR
TRANSIDERR
ENDDATA
INVTSREQ
EXPIRED
RETPAGE
RTEFAIL
RTESOME
TSIOERR
MAPFAIL
INVERRTERM
INVMPSZ
IGREQID
OVERFLOW
INVLDC
NOSTG
JIDERR
QIDERR
NOJBUFSP
DSSTAT
SELNERR
FUNCERR
UNEXPIN
NOPASSBKRD
NOPASSBKWR
SYSIDERR
ISCINVREQ
ENQBUSY
En RECEIVE MAP se recibe End Of Chain.

Se recibi Function Management Header.
Se recibi End Of Input Indicator
Nombre de Programa no es Valido.
No Inicializa el Programa de Aplicacin.
Nombre de Terminal no Existe en TCT.
El Archivo no Existe en la FCT(RESP2=01)
No existe el Registro (RESP2=80) READ, DELETE, STARTBR
El Registro ya Existe(WRITE,REWRITE).
Varios Registros con la Misma Clave(READ)
REWRITE sin READ UPDATE 0- READ No esta de acuerdo a FCT.
Peticin invlida.
Error de Hardware (Daado el disco)
No hay Espacio en Disco para Nuevos Registros.
Archivo Ocupado Por otra Transaccin. o cerrado
Fin de Archivo (READNEXT,READPREV).
Error no Catalogado Ver RESP2 Pg. 311. (Un error VSAM)
Longitud de Registro Diferente de LENGTH.
La QUEUE esta Vaca (READQ TD).
Entrada de Control SIGNAL.
La QUEUE esta ocupada por otro TASK.
Nmero de ITEM no Grabado al (READQ TS,WRITE TS).
El Programa o el Mapa no esta Declarado en la PPT.
La Transaccin no esta Declarada en la PCT.
No hay mas datos para el Task, usando RETRIEVE
No se Localiza.
Cuando un Comando Termina su duracin, que no se Utiliza.
Ocurre Cundo la Opcin SET esta Especificada.
Terminal no se encuentra Instalada, usando ROUTE.
Terminal no recibe el Mensaje de ROUTE.
Error de Entrada/Salida en la TS.
Recibe MAPA Vaco (Operador Oprimi Tecla CLEAR)
Identificador de Terminal no es Valido en ROUTE.
Cuando el MAPA es muy Grande para la Terminal(SEND RECIVE)
Cuando REQID de SEND MAP es Diferente del REQID anterior.
Los Datos del Mapa no Ajustan en la Pgina (SEND MAP).
Es cuando la LDC no esta Incluida en la lista de LDCs.
El rea Solicitada es Mayor Que el rea Disponible.
S el Identificador de JOURNAL no Existe.
La QUEUE no Existe,(READQ TS).
Los BUFFER del JOURNAL Estn Llenos.
El DESTINATION STATUS ha Cambiado (ISSUE RECEIVE).
Error en la Seleccin del DESTID (ISSUE QUERY).
Error Durante la Ejecucin de ISSUE QUERY.
Error Inesperado en ISSUE QUERY o ISSUE RECEIVE
No est presente el PASSBOOK en RECEIVE.
No est presente el PASSBOOK en SEND.
EL SYSID No est Definido en READ.
Falla en el Sistema Remoto RESP2=70
El recurso Solicitado no est Disponible en ENQ.

56
57
58
59
60
61
62
63
64
65
66
69
70
72
81
82
84
ENVDEFERR
IGREQCD
SESSIONERR
SYSBUSY
SESSBUSY
NOTALLOC
CBIDERR
INVEXITREQ
INVPARTNSET
INVPARTN
PARTNFAIL
USERIDERR
NOTAUTH
SUPPRESSED
TERMERR
ROLLEDBACK
DISABLED
87
94
OPENERR
LOADING
RETRIEVE especifico una opcin que no corresponde a START

Se ordeno SEND MAP despus de SIGNAL con CHANGE DIRECTION.
Session Invalido en ALLOCATE.
No hay SESSION Disponible en ALLOCATE MAPPED.
La session no se puede servir Inmediatamente en ALLOCATE.
RECEIVE se envi por una Transaccin generada por START
PROFILE de ALLOCATE no Existe.
No Localizada.
La Particin no es Valida en SEND PARTNSET.
La Particin no esta Definida en RECEIVE MAP o SEND MAP.
Operador insiste en Enviar a una Particin Invalida RECIVE.
Usuario Invalido en SIGNON.
Usuario No Autorizado a esta Funcin.
Usuario no aadi Registro a la Tabla con (WRITE UMT).
Error de Terminal.
El Programa no Puede Actualizar y hace el ROLLBACK.
El Archivo esta Deshabilitado (READ, WRITE, REWRITE,
DELETE, UNLOCK).
Error cundo se ABRE,CIERRA o se ESRCIBE la Rutina DUMP.
La Tabla Solicitada por READ UPDATE se esta Cargando.
Recomendaciones de formateo de pantallas

Reglas para color y posicin de los campos:
Reglas para asignar funcin de teclas:
Formato y contenido del byte de atributo
Contenido del byte atributo
Atributos extendidos
Modificar los atributos al byte atributo

Modificacin a los atributos de pantalla:
Subfijos de los campos de atributo
Copy con la definicin de atributos:
Procedimiento de jcl para ensamblar el mapa
Transacciones de servicio

CESN: The signo n transaction.
CESN [USER=username]
[PS=password]
CESF: The sign off transaction.

CESF [LOGOFF | GOODNIGHT]
CEMT: The master terminal transaction

Forzar una nueva copia del programa
CEMT SET PROGRAM(name) NEWCOPY
Abrir/cerrar un archivo
CEMT SET FILE(name) {OPEN | CLOSE}
Abilitar o deshabilitar un archivo o transaccin

CEMT SET PROGRAM(name) {DISABLED | ENABLED}
CEMT SET TRANSACTION(name) {DISABLED | ENABLED}
Checar el status de un archivo, programa o transaccin

CEMT INQUIRE {FILE(name) | PROGRAM(name) | TRANSACTION(name)}
CECI: Interprete de comandos

Herramienta til para lanzar comandos de cics como modo de prueba, como
por ejemplo SEND MAP, para mostrar el mapa sin que exista el programa
asociado.
{CECI | CECS}
Otros comandos de CICS
Comando para el uso del Intervalo de control del CICS

START
Nos permite comenzar una nueva tarea siendo ejecutado este comando en
otra tarea diferente. Para poder enviar datos entre tareas se hace uso de la
temporary storage. Cada tarea puede estar ejecutando un programa a la vez.
Es decir, mediante este comando podemos realizar un proceso multitarea.
START TRANSID(trans-id)
INTERVAL(hhmmss)
TIME(hhmmss)
AFTER [HOURS(hh)][MINUTES(mm)][SECONDS(secs)]
AT
[HOURS(hh)][MINUTES(mm)][SECONDS(secs)]
TERMID(term-id)
FROM (data-name)
RTERMID(term-id)
RTRANSID(trans-id)
QUEUE(queue-name)
REQID(request-id)
Especfica el identificador de la transaccin que ser usada para

comenzar una tarea.
TRANSID
INTERVAL Especfica un intervalo que CICS sumar al tiempo actual para
determinar cuando la tarea debera comenzar. Si una variable o nombre de

dato es especificado, debe ser declarado como un campo signado numrico
empacado de 4 bytes.
Especfica el tiempo cuando la tarea debera comenzar. Si el tiempo es
ms de 18 horas despus del tiempo actual, se considera que dicha tarea ya ha
expirado. Si un nombre de dato es especificado, debe ser declarado como un
campo signado numrico empacado de 4 bytes.
TIME
Indica que la tarea debera comenzar despus del intervalo

especificado en las opciones HOURS, M INUTES, and SECONDS.
AFTER
Indica que la tarea debera comenzar en el tiempo especificado en las

opciones HOURS, M INUTES, and SECONDS.
AT
HOURS Debe ser un nmero comprendido entre 0 y 99. Si un nombre de datos
es especificado, debe ser del tipo binario S9(08) COMP.

MINUTES Si HOURS o SECONDS son especificados, deben contener un nmero
entre 0 y 59. De lo contrario, puede ser un nmero entre 0 y 5999 (un minuto
menos que 100 horas). Si un nombre de datos es especificado, debe ser del
tipo binario S9(08) COMP.

SECONDS Si HOURS o MINUTES son especificados, deben contener un nmero
entre 0 y 59. De lo contrario, puede ser un nmero entre 0 and 359,999 (un
segundo menos que 100 horas). Si un nombre de datos es especificado, debe
ser del tipo binario S9(08) COMP.
Especfica el nombre de la terminal donde la tarea se ejecutar. Si se
omite, la tarea correr sin terminal.
TERMID
FROM Especfica el nombre del campo cuyo valor es pasado a la tarea a
comenzar.
RTERMID Especifica el identificador de la terminal en S9(09) COMP.
RTRANSID Especifica el identificador de la transaccin en S9(09) COMP.
QUEUE Especfica el nombre de la cola de la temporary storage de 8 bytes que
es pasada a la tarea.
REQID Especifica una valor de 8 bytes que identifica el comando START, para
que de esta manera pueda se cancelado con el comando CANCEL. Si se omite,
CICIS genera un identificador de peticin retornando el valor EIBREQID.
RETRIEVE
Para recuperar los datos pasados por un programa que inicia una nueva tarea a
travs del comando START, la tarea comenzada debe lanzar el comando
RETRIEVE. CICS lanzar una condicin NOTFND si al lanzar el comando ningn
dato fue enviado a la tarea empezada. Si el comando START incluye las
opciones RTRANSID, RTERMID, O QUEUE, el comando RETRIEVE tambin debe
tener indicado esas opciones.
Si se requiere enviar ms de un registro a la tarea por comenzar, se debe de
ejecutar por cada registro el comando START indicando la misma tarea.
Entonces, si el tiempo de expiracin y el identificador de la terminal son los
mismos cada vez que se lance el comando START, las peticiones se unirn en
una sola ejecucin de la tarea. Una vez comenzada la tarea se debe de lanzar
el comando RETRIEVE el nmero de veces de los registros enviados por START.
Si no hay ms registros por recuperar se lanza una condicin de ENDDATA.
RETRIEVE INTO(dataname)
[RTRANSID(dataname)]
[RTERMID(dataname)]
[QUEUE(dataname)]
INTO Especfica el nombre del campo donde los datos enviados por la opcin
FROM del comando START sern colocados.
RTRANSID Especfica el nombre de un campo de 4 bytes donde los datos
enviados por la opcin RTRANSID del comando START sern colocados.
RTERMID Especfica el nombre de un campo de 4 bytes donde los datos

enviados por la opcin RTERMID del comando START sern colocados.
QUEUE Especfica el nombre de un campo de 8 bytes donde los datos
enviados por la opcin QUEUE del comando START sern colocados.
CANCEL
Este comando nos sirve para cancelar la ejecucin de un determinada tarea, la
nica condicin que se requiere es que la tarea a cancelar an no se haya
ejecutado.
CANCEL REQID(requestid)
REQID Especfica un valor de 8 bytes que identifica el comando START a

cancelar.
Comandos para el uso del control de tareas de CICS

El control de tareas (task control) se refiere a las funciones de CICS para la
administracin de ejecucin de las diferentes tareas.
SUSPEND
Cuando una tarea esta monopolizando los recursos de la CPU, podemos lanzar
el comando SUSPEND (no tiene parmetros) para temporalmente regresar el
control al CICS, y de esta manera las dems tareas puedan ejecutarse.
ENQ y DEQ
Estos comandos permiten asegurar que una o ms tareas no tenga acceso aun recuso no compartido,
como una impresora al mismo tiempo. El comando ENQ se utiliza para bloquear el resurso no

compartido asignndolo a una nica tarea, de esta manera cualquier otra tarea que trate de tener
acceso al recurso se mantiene en espera. Con el comando DEQ se desbloque el recurso, para que
otra tarea diferente pueda tener acceso al recurso no compartido.
{ENQ | DEQ}
RESOURCE(dataname)
RESOURCE Especfica el nombre del campo que contiene el nombre del recurso a bloquear o
desbloquear. El campo puede ser desde 1 a 255 bytes de longitud.
Comandos para el uso del control de almacenamiento de

CICS
GETMAIN
Este comando se utiliza para signar una cantidad de la memoria principal especificada en la opcin
FLENGHT (por default la cantidad asignada es de 16 MB, se puede asignar una cantidad menor
usando la opcin BELOW. La opcin SET establece direccionamiento hacia al rea asignando su
direccin a un campo definido en la Linkage section de un programa. Con la opcin INITIMG se
inicializa el rea adquirida a un determinado valor.
GETMAIN SET(pointer)
FLENGTH(dataname | literal) [BELOW]
[INITIMG(dataname)]
SET. Establece direccionamiento al rea asignando la direccin a un campo de la linkage section.

FLENGTH Especifica la cantidad de bytes a utilizar de la memoria principal, si se inserta un
nombre de dato se define como S9(8) COMP.
Ejemplo:
FREEMAIN
Se utiliza para liberar un rea de memoria asignada por GETMAIN. Para identificar el rea de
almacenamiento se codifica ya sea la opcin DATA o DATAPOINTER. Si se especifica DATA, slo
se especfica el nombre del campo de linkage section que se usa para tener acceso a la memoria
asignada por GETMAIN. Por el contrario, si se especfica DATAPOINTER, se debe de pasar la
direccin del rea asignada usando el registro especial ADDRESS.
EXECCICSFREEMAINDATA(PRODUCTRECORD)ENDEXEC.
EXECCICSFREEMAINDATAPOINTER(ADDRESSOFPRODUCTRECORD)ENDEXEC.
Comandos para el uso del proceso de recuperamiento

(journal control)
Cuando una tarea o el CICS fallan, los archivos y otros recursos en proceso de ser actualizados
pueden quedar en un inconsistente estado. Cuando esto pasa, la mejor opcin es revertir todos los
cambios hechos por la transaccin, en el siguiente apartado se describen los comandos encargados
de realizar esta tarea.
SYNCPOINT
Este comando nos sirve para informar al CICS que los cambios efectuados a los
recursos protegidos cuando ocurre un ABEND son definitivos y no es necesario
regresar a la imagen anterior. Del mismo modo se puede indicar que realice
una operacin de ROLLBACK si se suscitar un error en el programa.
SYNCPOINT [ROLLBACK]
ROLLBACK Indica que las actualizaciones realizadas desde la ltima vez que
se invoc el comando SYNCPOINT (o el principio de la ejecucin de la tarea)
deben revertirse.
Ejemplo:
Control de versiones del documento

Fecha de ultima
modificacin
19/01/2012
Autor
Versin
Jorge Flores Miguel
1.0
Este documento fue creado por el Ing. Jorge Flores Miguel para uso de
apoyo y aprendizaje.

Apuntes de Sentencias de Cics

Caricato da

Informazioni sul documento

Descrizione originale:

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Apuntes de Sentencias de Cics

Caricato da

Copyright:

Formati disponibili

[RESUMEN DE

[RESUMEN DE ELEMENTOS DE CICS]

Tablas del CICS.................................................................................................... 7

[RESUMEN DE ELEMENTOS DE CICS]

[RESUMEN DE ELEMENTOS DE CICS]

[RESUMEN DE ELEMENTOS DE CICS]

[RESUMEN DE ELEMENTOS DE CICS]

[RESUMEN DE ELEMENTOS DE CICS]

Tablas del CICS

reas de comunicacin para pasar datos de un

Declaracin en COBOL para accede a los datos.

LLAMAR AUN PROGRAMA EN CICS

XCTL Transfiere el control a un programa del mismo nivel lgico.

El error ms comn en la transferencia es:

[RESUMEN DE ELEMENTOS DE CICS]

El rea de comunicaciones indicada en COMMAREA debe estar declarada en la

Comunicaciones con el mapa

ERASE indica que se debe borrar el BUFFER de pantalla antes de que se

[RESUMEN DE ELEMENTOS DE CICS]

En caso de un error en la recepcin del mapa, se genera el cdigo 36 (MAPFAIL)

Sentencias de obtencin de la fecha y hora

[RESUMEN DE ELEMENTOS DE CICS]

Variantes del formato de fecha

Operaciones con ficheros

Si se utiliza la opcin UPDATE, se localiza un registro para posteriormente

[RESUMEN DE ELEMENTOS DE CICS]

WRITE Escritura de un archivo VSAM

En caso de que la clave de acceso en RIDFLD ya exista en el archivo (CLAVE

[RESUMEN DE ELEMENTOS DE CICS]

SENTENCIAS DE ACTUALIZACIN DE ARCHIVOS

DELETE Si se especfica la clausula UPDATE en read, se puede borrar un determinado

Se puede eliminar un grupo de registros con un solo comando DELETE,

WRITEQ TS Aade un nuevo registro a la cola. Si la cola no existe, se crea

[RESUMEN DE ELEMENTOS DE CICS]

Si el numero de tem no se localiza en la cola, se genera el cdigo 26

El cdigo 44 (QIDERR) corresponde a un error en el nombre de la cola, es

Revisin de un archivo: Browse

[RESUMEN DE ELEMENTOS DE CICS]

READPREV Lee un registro anterior

READNEXT Lee el siguiente registro

ENDBR Finaliza el browse

El valor REQID es un identificador (S9(04) COMP-3) numrico que se usa para

[RESUMEN DE ELEMENTOS DE CICS]

Interface de Programacin de Alto Nivel (HLPI)

[RESUMEN DE ELEMENTOS DE CICS]

[RESUMEN DE ELEMENTOS DE CICS]

Basic Mapping Support (BMS)

[RESUMEN DE ELEMENTOS DE CICS]

Mapacon el que est asociado. Suministra

Es generado al compilar el mapa fsico por el compilador

Macros para la generacin de Mapas

Un MAPSET puede contener varios mapas y al ensamblarse, se generan varios

[RESUMEN DE ELEMENTOS DE CICS]

(Libera el teclado). El teclado se bloquea automticamente tan pronto como el

[RESUMEN DE ELEMENTOS DE CICS]

NOTA: El nombre del campo no debe de rebasar los 7 caracteres .

NOTA: El nombre del campo no debe de rebasar los 7 caracteres.

[RESUMEN DE ELEMENTOS DE CICS]

El campo se exhibe con intensidad Normal.

El campo se exhibe con intensidad Brillante.

El campo se exhibe obscuro (no se ve)

No se puede teclear en el campo, y si el campo anterior esta lleno, el

No se puede teclear en el campo, pero el cursor no brinca sobre este