Prévia do material em texto
____________________________________________________________________________________________ COBOL CICS COMMAND LEVEL ___________________________________________________________________________________________ CICS – COBOL Command Level 2 1. Legenda dos Componentes Orientativos. .................................................... 6 2. Introdução....................................................................................................... 7 3. UNIDADE 1 .................................................................................................... 8 3.1 Conceitos fundamentais e pseudo-conversação ...........................................................8 3.2 Customer Information Control System........................................................................8 3.3 A comunicação entre CICS............................................................................................8 3.4 Conceitos .........................................................................................................................9 3.5 Executando transações...................................................................................................9 3.6 Execução concorrente de tasks......................................................................................9 3.7 Formato dos comandos ................................................................................................10 3.8 Argumentos ...................................................................................................................10 3.9 Comandos básicos.........................................................................................................11 3.9.1 Comando RECEIVE...............................................................................................11 3.9.1.1 Condições de Exceção - RESP...............................................................................12 3.9.2 Comando SEND .....................................................................................................13 3.9.3 Posicionamento de Cursor......................................................................................14 3.9.4 Formatação de Data e Hora ....................................................................................15 3.10 Exec Interface Block (EIB) ......................................................................................17 3.11 Compilação de Programas.......................................................................................17 3.12 Conversacional x Pseudo-conversacional...............................................................17 3.13 Pseudo-conversacional .............................................................................................18 3.14 Passagem de dados para próxima task...................................................................18 3.15 Pseudo-Conversacional – utilizando commarea ....................................................18 3.16 COBOL sob CICS – Restrições...............................................................................19 4. UNIDADE 2 .................................................................................................. 21 4.1 BASIC MAPPING SUPPORT ....................................................................................21 4.2 Definição de mapas.......................................................................................................21 4.3 Campos 3270 .................................................................................................................21 4.4 Campos formatados 3270.............................................................................................22 4.5 Definindo um mapa ......................................................................................................23 4.6 Compilação de um mapa..............................................................................................24 4.7 Mapas e Programas......................................................................................................24 4.8 Enviando Mapas ...........................................................................................................26 4.8.1 Send Map................................................................................................................26 4.8.2 Opções ....................................................................................................................27 4.9 Recebendo Mapas – Receive Map...............................................................................29 ___________________________________________________________________________________________ CICS – COBOL Command Level 3 4.10 Manuseio de teclas e atributos.................................................................................30 5. UNIDADE 3 .................................................................................................. 32 5.1 Envio e recepção de mapas ..........................................................................................32 5.2 Mapa simbólico – WORKING X LINKAGE ............................................................32 5.3 Recebendo Mapa na LINKAGE SECTION ..............................................................32 5.4 Send Map – Constantes e variáveis.............................................................................33 5.5 Receive Map – Constantes e variáveis ........................................................................33 5.6 Send Map – Funções de controle.................................................................................34 5.7 RECEIVE – tecla e cursor ...........................................................................................35 5.8 Edição de campos – Built in Function ........................................................................35 6. UNIDADE 4 .................................................................................................. 36 6.1 Acessando VSAM .........................................................................................................36 6.2 VSAM – Recuperação Direta ......................................................................................36 6.2.1 VSAM ESDS..........................................................................................................36 6.2.2 VSAM RRDS .........................................................................................................37 6.2.3 VSAM KSDS .........................................................................................................38 6.2.4 Campo Chave (RIDFLD) .......................................................................................38 6.2.5 Comando para Leitura - READ..............................................................................38 6.2.6 Condições de exceção.............................................................................................39 6.3 VSAM – Recuperação Seqüencial (BROWSE) .........................................................41 6.3.1 Comandos para recuperação seqüencial .................................................................41 7. UNIDADE 5 .................................................................................................. 44 7.1 Atualizando VSAM ......................................................................................................44 7.2 Considerações sobre integridade.................................................................................44 7.3 Controle exclusivo – VSAM x CICS ...........................................................................44 7.4 A necessidade de proteção ...........................................................................................44 7.5 LUW e Backout.............................................................................................................4549 Este modelo de desenho conversacional não é recomendado, pois o tempo de espera para outras task depende de um usuário. E se por exemplo, ele demorar 10 minutos para enviar suas alterações? 7.13 Desenho Pseudo-conversacional Para resolver o problema mostrado no item acima, temos a técnica pseudo- conversacional. A leitura para enviar os dados ao usuário não prende nenhum recurso. Se o tempo de ação do usuário for lento, ninguém será prejudicado. O controle exclusivo somente ocorrerá após o programa receber as alterações digitadas, e terá uma duração muito curta. Mas e se o registro for alterado entre o tempo decorrido após a leitura na 1ª fase e as leitura para update na 2ª fase? A resposta para esse problema é salvar a imagem do registro quando for feita a primeira leitura. Quando o programa fizer a leitura para update na 2ª fase, deverá comparar o registro lido com a imagem que foi salva. Se estiverem iguais, podemos efetivar as alterações. Caso contrário, devemos tomar alguma providência. Onde salvar a imagem do registro? Que tal na COMMAREA? Ou então em TS (como veremos adiante). ___________________________________________________________________________________________ CICS – COBOL Command Level 50 7.14 Gravação de registros - WRITE Para incluir um novo registro em um arquivo VSAM, devemos formatar os dados na área do registro em WORKING, estabelecer o campo chave (RIDFLD) e gravá-lo através do comando WRITE. EXEC CICS WRITE FILE (name) FROM (data-area) RIDFLD (data-area) [LENGTH (data-value)] [RBA | RRN] [MASSINSERT] END-EXEC. O comando WRITE adiciona registros em um arquivo VSAM. A opção MASSINSERT serve para otimizar uma inclusão de registros em massa, desde que estejam em ordem ascendente de chave. Nesse caso, o MASSINTERT deve ser codificado em cada registro. Quando a seqüência de inclusões terminar, devemos emitir um comando UNLOCK. No caso de inclusão de arquivo ESDS, o campos RIDFLD será alimentado pelo CICS com o RBA do registro incluído. MOVE ‘00003’ TO W-CHAVE. MOVE ‘PHEYSEY’ TO REG-NOME. MOVE ‘SÃO PAULO’ TO REG-CIDADE. MOVE EIBDATE TO REG-DATA. MOVE EIBTIME TO REG-HORA. EXEC CICS WRITE FILE (‘ARQ1’) FROM (W-REG) RIDFLD (W-CHAVE) RESP (W-ERR) ___________________________________________________________________________________________ CICS – COBOL Command Level 51 END-EXEC. IF W-ERR EQUAL DFHRESP(DUPREC) MOVE ‘REGISTRO JÁ EXISTENTE’ TO MSGO .... ELSE IF W-ERR NOT EQUAL DFHRESP(NORMAL) PERFORM ROT-ERRO. ... ___________________________________________________________________________________________ CICS – COBOL Command Level 52 8. UNIDADE 6 8.1 Controle de programas Veremos agora os comandos de transferência de controle entre programas em uma mesma task: - CICS: LINK e XTCL - COBOL: CALL estático e dinâmico. Veremos também como é feita a passagem de dados entre os programas. 8.2 Link entre programas O comando Link passa o controle para o programa indicado, esse programa executa e ao terminar, devolve o controle ao programa que emitiu o Link (chamador). Os dois programas são executados sob a mesma task. 8.3 Passagem de Dados Usando LINK Assim como na pseudo-conversação, também utilizamos a Commarea para passagem de dados entre os programas no comando LINK. O programa chamador ( o que emite o LINK) passa como commarea uma área de WORKING-STORAGE. O programa que recebe o controle vai acessar os dados passados através da DFHCOMMAREA em sua LINKAGE SECTION. Se os dados recebidos na DFHCOMMAREA pelo programa chamado forem alterados, quando esse terminar e o controle voltar para o programa chamador, a área de WORKING que foi passada como commarea também estará alterada. ___________________________________________________________________________________________ CICS – COBOL Command Level 53 Os dois programas devem estar definidos na PPT do CICS. 8.4 Níveis lógicos - LINK NÍVEL 0 NÍVEL 1 NÍVEL 2 Todo programa chamado através de LINK executa em novo nível lógico. Quando termina (RETURN), o controle volta para o nível lógico imediatamente superior, ou seja, para o programa que emitiu o LINK. PROGRAM-ID. PROG1. WORKING-STORAGE SECTION. 77 W-ERR PIC S9(08) COMP. CICS Primeiro Programa LINK Segundo Programa RETURN ___________________________________________________________________________________________ CICS – COBOL Command Level 54 01 W-COMM PIC X(03) VALUE ‘SIM’. .... PROCEDURE DIVISION. ... EXEC CICS LINK PROGRAM (‘PROG2’) COMMAREA (W-COMM) END-EXEC. ... PROGRAM-ID. PROG2. WORKING-STORAGE SECTION. 77 W-FLAG PIC X(03). LINKAGE SECTION. 01 DFHCOMMAREA. 02 L-COMM PIC X(03). PROCEDURE DIVISION. .. MOVE L-COMM TO W-FLAG. ... EXEC CICS RETURN END-EXEC. O programa PROG1 está fazendo um LINK para o programa PROG2 e passando como commarea a área W-COMM. O programa PROG2 recebe esta área em LINKAGE, na DFHCOMMAREA. 8.5 XCTL entre programas O comando XCTL também passa controle para outro programa, mas ao contrário do LINK, quando o programa chamado termina, o controle não retorna ao programa chamador. O XCTL é muito utilizado para desenvolver MENUS de aplicações. 8.6 Passagem de dados usando XCTL A passagem de dados entre os programas também é feita através da Commarea. O programa que emite o XCTL utiliza uma área e WORKING como Commarea, e o programa que torna o controle recebe os dados na DFHCOMMAREA. ___________________________________________________________________________________________ CICS – COBOL Command Level 55 8.7 Níveis lógicos - XCTL NÍVEL 0 NÍVEL 1 NÍVEL 2 Como vimos, um programa chamado através de LINK executa em um novo nível lógico. Já um programa chamado através de XCTL executa no mesmo nível lógico do programa que fez a chamada. Como o RETURN volta para o nível lógico imediatamente superior, temos a confirmação que no caso do XCTL o controle não retorna para o programa que fez a chamada. PROGRAM-ID. PROG1. WORKING-STORAGE SECTION. 77 W-ERR PIC S9(08) COMP. 01 W-COMM PIC X(03) VALUE ‘SIM’. .... PROCEDURE DIVISION. ... EXEC CICS XCTL PROGRAM (‘PROG2’) COMMAREA (W-COMM) END-EXEC. ... PROGRAM-ID. PROG2. CICS Primeiro Programa LINK XCTL Segundo Programa RETURN Terceiro Programa RETURN ___________________________________________________________________________________________ CICS – COBOL Command Level 56 WORKING-STORAGE SECTION. 77 W-FLAG PIC X(03). LINKAGE SECTION. 03 DFHCOMMAREA. 04 L-COMM PIC X(03). PROCEDURE DIVISION. .. MOVE L-COMM TO W-FLAG. ... EXEC CICS RETURN END-EXEC. O exemplo acima mostra o PROG1 fazendo um XCTL para o programa PROG2 e passando como commarea a área W-COMM. O programa PROG2 assume o controle e recebe os dados na DFHCOMMAREA. Passagem de controle: XCTL � programa recebe eibcalen diferente de zeros. START � programa recebe eibcalen igual a zeros, devemos, portanto, executar o comando RETRIEVE para restaurar a commarea. 8.8 Cuidados com a LINKAGE SECTION Devemos sempre utilizar os mesmos tamanhos de commarea quando vamos passar controle a outro programa. 8.9 Call estático – COBOL CALL LITERAL: CALL ‘PROGB’ OS/COBOL VS COBOL II PGM CHAMADOR V V ___________________________________________________________________________________________CICS – COBOL Command Level 57 PGM CHAMADO COMANDOS CICS OS/COBOL VS COBOL II ASSEMBLER X V X V V X V V Apenas um módulo executável. O Call estático do Cobol (call literal) pode ser utilizado sob CICS. A tabela acima mostra as possibilidades de CALL dependendo do compilador COBOL utilizado. Os programas chamador e chamado são linkeditados como um único módulo executável. Do ponto de vista de performance, é uma boa opção, uma vez que não ocorrerá carga do programa chamado na memória. Por outro lado, se diversos programas fizerem CALL para esse mesmo programa teremos diversas cópias dele em memória. 8.10 Call dinâmico – COBOL MOVE ‘PROGB’ TO W-PROG CALL VARIÁVEL: CALL W-PROG. OS/COBOL VS COBOL II PGM CHAMADOR V V PGM CHAMADO COMANDOS CICS X V ___________________________________________________________________________________________ CICS – COBOL Command Level 58 OS/COBOL VS COBOL II ASSEMBLER X X X X V V Dois módulos executáveis. O Call dinâmico do Cobol (call variável) também pode ser utilizado. A tabela acima mostra as possibilidades de call dependendo do compilador COBOL utilizado. Os programas chamador e chamado são linkeditados separadamente, sendo dois módulos executáveis distintos. Quando for feito um call, o programa chamado será carregado em memória e executado. Se diversos programas fizerem call para esse mesmo programa, teremos apenas uma cópia em memória. 8.11 Passagem de dados com INPUTMSG A partir do CICS/ESA v3.1.1 temos uma alternativa a mais para passagem de dados entre programas. Trata-se da opção INPUTMSG. Através dela, podemos passar uma área que fica na WORKING-STORAGE do programa chamador, e recebê-la também em WORKING-STORAGE no programa chamado, através do comando RECEIVE. Se desejarmos, podemos especificar tanto o INPUTMSG quanto a COMMAREA em um mesmo comando. O INPUTMSG é válido para LINK e XCTL a partir do CICS V3.1.1. A partir do CICS V3.2.1 é válido também para RETURN TRANSID. PROGRAM-ID. PROG1. WORKING-STORAGE SECTION. 77 W-ERR PIC S9(08) COMP. 01 W-INPUT. 02 W-TRANS PIC X(04). 02 W-CHAVE PIC X(05). .... PROCEDURE DIVISION. ... EXEC CICS XCTL PROGRAM (‘PROG2’) ___________________________________________________________________________________________ CICS – COBOL Command Level 59 INPUTMSG (W-INPUT) INPUTLEN (9) END-EXEC. ... PROGRAM-ID. PROG2. WORKING-STORAGE SECTION. 01 W-RECEBE. 02 W-TRN PIC X(04). 02 W-KEY PIC X(05). PROCEDURE DIVISION. .. EXEC CICS RECEIVE INTO (W-RECEBE) END-EXEC. .. EXEC CICS RETURN END-EXEC. O programa PROG1 está chamando o PROG2 através de XCTL e passando a área W-INPUT como INPUTMSG. O PROG2 ao receber o controle executa o comando RECEIVE e recebe os dados na área W-RECEBE. ___________________________________________________________________________________________ CICS – COBOL Command Level 60 9. UNIDADE 7 9.1 Addressability – uso da LINKAGE SECTION A LINKAGE SECTION é uma área muito explorada pelo CICS em nossos programas COBOL. Já percebemos que o EIB e a DFHCOMMAREA localizam- se em LINKAGE. Além dessas duas áreas, podemos utilizar a LINKAGE para diversos outros fins, pois ela é uma excelente alternativa ao uso da WORKING. O único cuidado que devemos ter é com o tamanho das áreas e sua “addressability”, ou seja estabelecer o endereçamento para poder utilizá-las. 9.2 Addressability - DFHCOMMAREA e DFHEIBLK: Endereçados automaticamente pelo próprio CICS. - Outras área de LINKAGE: Devem ser endereçadas pelo programa O endereçamento do DFHEIBLK (EIB) e da DFHCOMMAREA é feito de forma automática pelo CICS. O endereçamento de outras área deve ser feito pelo próprio programa, portanto é responsabilidade do programador. ___________________________________________________________________________________________ CICS – COBOL Command Level 61 9.3 BLL Cells – OS/VS cobol LINKAGE SECTION. 01 DFHCOMMAREA. ... 01 BLL-CELLS. 05 FILLER PIC S9(08) COMP. 05 PRT-REG PIC S9(08) COMP. 05 PRT-TAB PIC S9(08) COMP. 01 L-REG. 05 NOME PIC X(30). 05 ENDEREÇO PIC X(40). 05 CPF PIC 9(11). ... 01 L-TAB. ... Para o compilador OS/COBOL, toda vez que necessitarmos trabalhar com áreas em LINKAGE (exceto DFHEIBLK e DFHCOMMAREA), temos que criar uma estrutura de ponteiros denominada BLL Cells (Células de base locator for LINKAGE). A estrutura de BLL Cells deve ser um nível 01 imediatamente antes dos layouts das áreas de trabalho em LINKAGE do programa. O primeiro ponteiro da estrutura vai conter o endereço da própria estrutura, e é carregado pelo próprio COBOL. Cada ponteiro seguinte apontará para um layout de nível 01 codificado após a estrutura de BLLs. Esses ponteiros devem ser carregados pelo programa. ___________________________________________________________________________________________ CICS – COBOL Command Level 62 9.4 Opção SET – utiliza LINKAGE SECTION. PROGRAMA OS/COBOL: EXEC CICS READ FILE (‘ARQ1’) RIDFLD (REG-CHAVE) SET (PTR-REG) END-EXEC. PROGRAMA COBOL II: EXEC CICS READ FILE (‘ARQ1’) RIDFLD (REG-CHAVE) SET (ADDRESS OF L-REG) END-EXEC. Acima mostramos um registro de arquivo VSAM sendo lido em LINKAGE SECTION ao invés da WORKING. Note que no lugar da opção INTO está sendo utilizada a opção SET. Dessa forma, quando o CICS faz a leitura já adquire uma área de memória do tamanho do registro. A opção SET serve para carregar o ponteiro do BLL com o endereço da área onde encontra-se o registro. O primeiro exemplo mosta um programa OS/COBOL. A opção SET informa o campo PRT-REG. Esse campo é um ponteiro BLL, mostrado no item 8.3. O segundo exemplo mostra um programa COBOL II. Neste caso é bem mais simples, pois o COBOL II não utiliza a estrutura de ponteiros. Ao invés disso, utiliza um registrador especial de endereçamento para cada nível 01 da LINKAGE, e para carregar esse registrador o programa deve utilizar a instrução “ADDRESS OF nível-01”. 9.5 Tabelas em Assembler DC CL2’SP’ DC CL15’SÃO PAULO’ DC CL2’BA’ DC CL15’BAHIA’ DC CL2’RJ’ DC CL15’RIO DE JANEIRO’ ___________________________________________________________________________________________ CICS – COBOL Command Level 63 DC CL2’PR’ DC CL15’PARANÁ’ DC CL2’ES’ DC CL15’ESPÍRTO SANTO’ Uma técnica muito utilizada no CICS é a codificação de tabelas em Assembler. Trata-se de um programa Assembler composto apenas de constantes. Acima mostramos uma tabela de Estados. Essa tabela será compilada, linkeditada e cadastrada na PPT do CICS. Ao invés de definir o layout dessa tabela na WORKING do programa, podemos fazer sua definição em LINKAGE, e carregá-la em memória quando quisermos consultá-la. Para carregá-la em memória veremos o comando LOAD. Com essa técnica, podemos ter inúmeras tasks no CICS consultando uma única tabela através de LINKAGE, possibilitando grande economia de memória no caso de tabelas extensas. 9.6 Carga de tabelas COBOL II -LOAD PROGRAM-ID. PROG1. WORKING-STORAGE SECTION. 77 W-ERR PIC S9(08) COMP. ... LINKAGE SECTION. 01 DFHCOMMAREA. 02 L-COMM PIC X(03). 01 TAB-LOCAL. 02 LOCAL OCCURS 120. 03 LOC PIC X(02). 03 DESC PIC X(15). PROCEDURE DIVISION. .... ___________________________________________________________________________________________ CICS – COBOL Command Level 64 EXEC CICS LOAD PROGRAM (‘TABPROG’) SET (ADDRESS OF TAB-LOCAL) END-EXEC. O comando LOADfaz com que o programa solicitado seja carregado em memória e o nosso programa tenha acesso ao endereço de carga através da opção SET. O LOAD carrega o programa mas não executa, ao contrário do LINK e XCTL. Através do layout em LINKAGE, podemos consultar as ocorrências da tabela. O LOAD mantém o programa carregado em memória até o final da task. Se após o final da task desejarmos manter o programa em memória, devemos utilizar a opção HOLD. Assim, o programa permanecerá em memória até o CICS sair do ar ou alguma transação emitir o comando RELEASE PROGRAM. 9.7 Adquirindo memória – COBOL II PROGRAM-ID. PROG1. WORKING-STORAGE SECTION. 77 W-ERR PIC S9(08) COMP. ... LINKAGE SECTION. 01 DFHCOMMAREA. 02 L-COMM PIC X(03). 01 L-AREA PIC X(300). PROCEDURE DIVISION. .... EXEC CICS GETMAIN LENGTH (300) SET (ADDRESS OF L-AREA) END-EXEC. MOVE ‘XXXXXXXXX’ TO L-AREA. ..... ___________________________________________________________________________________________ CICS – COBOL Command Level 65 O CICS possibilita também que um programa solicite uma área de memória. Isso é feito através do comando GETMAIN. No exemplo acima o programa está solicitando uma área de memória de tamanho 300 bytes, que será utilizada através do layout L-AREA em LINKAGE. 9.8 Áreas maiores que 4096 – COBOL II Se a área de LINKAGE tiver tamanho acima de 4096 bytes, não existe nenhuma consideração especial na codificação do programa COBOL II. Teremos acesso aos 7300 bytes da L-AREA sem nenhum esforço adicional. PROGRAM-ID. PROG1. WORKING-STORAGE SECTION. 77 W-ERR PIC S9(08) COMP. ... LINKAGE SECTION. 01 DFHCOMMAREA. 02 L-COMM PIC X(03). 01 L-AREA PIC X(7300). PROCEDURE DIVISION. .... EXEC CICS GETMAIN LENGTH (7300) SET (ADDRESS OF L-AREA) END-EXEC. MOVE ‘XXXXXXXXX’ TO L-AREA. ..... 9.9 Acessando a Common Work Area (CWA) O CICS fornece várias áreas de uso comum, e uma das mais práticas é a Common Work Area. Cada CICS tem uma CWA, e essa CWA pode ser acessada por todas as tasks. Ela serve para armazenar dados de utilização pública de qualquer espécie. ___________________________________________________________________________________________ CICS – COBOL Command Level 66 PROGRAM-ID. PROG1. WORKING-STORAGE SECTION. 77 W-ERR PIC S9(08) COMP. 77 W-LEN PIC S9(04) COMP. ... LINKAGE SECTION. 01 DFHCOMMAREA. 02 L-COMM PIC X(03). 01 L-CWA. 02 CWA-CAMPO1 PIC X(50). 02 CWA-CAMPO2 PIC X(50). PROCEDURE DIVISION. .... EXEC CICS ASSIGN CWALENG(W-LEN) END-EXEC. IF W-LEN GREATER ZEROS EXEC CICS ADDRESS CWA(ADDRESS OF L-CWA) END-EXEC. ..... Através do comando ASSIGN CWALENG verificamos se a CWA existe ou não. Se existir, é possível acessá-la através do comando ADDRESS CWA. Pelo layout da CWA na LINKAGE do programa, podemos consultar dados existentes ou então carregar novos dados. ___________________________________________________________________________________________ CICS – COBOL Command Level 67 10. UNIDADE 8 10.1 Queueing Nessa unidadade veremos os comandos necessários para trabalhar com as duas facilidades que o CICS oferece para armazenamento temporário de dados (enfileiramento de dados): Transient Data (TD) e Temporary Storage (TS). 10.2 Transient Data - TD INTRA- EXTRAPARTITION PARTITION As filas de Transient Data são identificadas por um nome de 4 caracteres cadastrado na tabela DCT (Destination Control Table) e conhecido com DESTID (Destination ID). O CICS oferece dois tipos de TD: intrapartition e Extrapartition. 10.2.1 TD Intrapartition PROGRAMA DFHDCT EXE DFHINTRA/VSAM ESDS CICS T D P D C T PROGRAMA Exec cics Readq/writeq TD EXEC CICS READQ/WRITEQ TD DFHTDP DESTID ___________________________________________________________________________________________ CICS – COBOL Command Level 68 Características da TD Intrapartition: - Todas as filas de TD são direcionadas para o mesmo arquivo VSAM ESDS chamado DFHINTRA; - Os registros nas filas são gravados sempre sequencialmente e recuperados da mesma forma; - A leitura é destrutiva, ou seja, uma vez lido não pode ser recuperado novamente; - Os registros podem ter tamanho variável. 10.2.2 TD Extrapartition PROGRAMA DFHDCT A TD Extrapartition é a forma que o CICS oferece para utilizarmos arquivos SAM (Sequencial Access Method). Características da TD Extrapartition: - Cada fila de TD corresponde a um arquivo físico; - A leitura não é destrutiva, pois podemos ler o mesmo registro diversas vezes; - Não podemos fazer exclusão; - Os registros podem ter formato fixo ou variável, blocado ou não blocado; - Cada fila pode ser definida com imput ou output, nunca como input e output. DFHTDP DESTID ___________________________________________________________________________________________ CICS – COBOL Command Level 69 10.3 Gravação de TD EXEC CICS WRITEQ TD QUEUE (name) FROM (data-area) [LENGTH (data-area)] END-EXEC. O comando WRITEQ TD é utilizado para gravação de TDs Intrapartition e Extrapartition. MOVE ‘00003’ TO W-CHAVE. EXEC CICS STARTBR FILE (‘ARQ1’) RIDFLD (W-CHAVE) RESP (W-ERR) END-EXEC. IF W-ERR EQUAL DFHRESP(NORMAL) PERFORM UNTIL W-ERR EQUAL DFHRESP(ENDFILE) EXEC CICS READNEXT FILE (‘ARQ1’) INTO (W-REG) RIDFLD (W-CHAVE) RESP (W-ERR) END-EXEC IF W-ERR EQUAL DFHRESP(NORMAL) MOVE EIBTIME TO TD-HORA MOVE W-NOME TO TD-NOME MOVE W-QTDE TO TD-QTD EXEC CICS WRITEQ TD QUEUE (‘TD01’) FROM (TD-REG) RESP (TD-ERR) END-EXEC ..... END-PERFORM EXEC CICS ENDBR FILE (‘ARQ1’) END-EXEC ELSE ....... O exemplo acima mostra uma lógica onde, para cada registro lido no arquivo ARQ1, está sendo gravado um registro na fla TD01. 10.4 Leitura de TD EXEC CICS READQ TD QUEUE (name) INTO (data-area) [LENGTH (data-area)] ___________________________________________________________________________________________ CICS – COBOL Command Level 70 END-EXEC. O comando READQ TD é utilizado para leitura de TDs Intrapartition e Extrapartition. PERFORM UNTIL W-ERR EQUAL DFHRESP(QZERO) EXEC CICS READQ TD QUEUE (‘TD01’) INTO (TD-REG) RESP (W-ERR) END-EXEC IF W-ERR EQUAL DFHRESP(NORMAL) .... ELSE IF W-ERR NOT EQUAL DFHRESP(QZERO) PERFORM TRATA-ERRO END-IF END-IF END-PERFORM O programa está lendo a TD01 sequencialmente até o seu fim (QZERO). 10.5 Exclusão de TD EXEC CICS DELETEQ TD QUEUE (name) END-EXEC. O comando DELETEQ TD aplica-se apenas para TDs Intrapartition. Este comando exclui todos os registros de uma fila TD. 10.6 Condições de exceção - TD � QZERO � LENGERR � NOSPACE � NOTOPEN � QIDERR � IOERR ___________________________________________________________________________________________ CICS – COBOL Command Level 71 Condições de exceção a serem consideradas para TDs: - QZERO: Fila vazia ou fim de fila; - LENGERR: Registro maior que o tamanho especificado; - NOSPACE: Arquivo DFHINTRA está cheio; - NOTOPEN: Fila TD Extrapartition está fechada; - QIDERR: A fila TD não foi cadastrada na tabela DCT; - IOERR: Problemas com o arquivo. 10.7 Temporary Storage - TS DFHTEMP VSAM (ESDS) A Temporary Storage( TS ) tem nomes de 1 a 8 caracteres, e não necessita que esses nomes sejam pré-definidos em tabelas do CICS. Se a fila não existir, ela será criada. - As filas TS podem ser gravadas em disco (AUX) ou então em memória (MAIN), onde o acesso é muito mais rápido; - Os registros (itens) podem ter tamanho variável; - TS aceita gravação sequencial, leitura sequencial e direta, e atualização; - Os dados permanecem disponíveis até que sejam excluídos por comando. TS DFHTSP EXEC CICS READQ/WRITEQ TS ___________________________________________________________________________________________ CICS – COBOL Command Level 72 Se a fila já existir, o programa acrescentará dados nela, portanto devemos sempre, ao iniciar o programa, tratar para criar uma TS nova. 10.8 Gravação de TS EXEC CICS WRITEQ TS QUEUE (name) FROM (data-area) [LENGTH (data-area)] [ITEM (data-area) [REWRITE]] [MAIN | AUXILIARY] END-EXEC. O comando WRITEQ TS é utilizado para gravação de filas TS. - As opções MAIN e AUX determinam se a fila será gravada em memória ou disco; - Quando estivermos gravando, se codificarmos a opção ITEM, o CICS retorna o número (posição) desse ítem na fila; - Se codificarmos as opções ITEM e REWRITE, o CICS fará atualização do ítem indicado com o novo conteúdo. Cada registro gravado é um novo item. ___________________________________________________________________________________________ CICS – COBOL Command Level 73 WORKING-STORAGE SECTION. 01 W-ITEM PIC S9(04) COMP. 01 TS-REG. ..... PROCEDURE DIVISION. EXEC CICS WRITEQ TS QUEUE (‘FATTS01’) FROM (TS-REG) ITEM (W-ITEM) RESP (W-ERR) END-EXEC. IF W-ERR NOT EQUAL DFHRESP(NORMAL) PERFORM TRATA-ERRO. Acima temos um exemplo de codificação de gravação de um ítem na fila TS FATTS01. WORKING-STORAGE SECTION. 01 W-ITEM PIC S9(04) COMP. 02 TS-REG. ..... PROCEDURE DIVISION. MOVE 10 TO W-ITEM EXEC CICS WRITEQ TS QUEUE (‘FATTS01’) FROM (TS-REG) ITEM (W-ITEM) REWRITE RESP (W-ERR) END-EXEC. IF W-ERR NOT EQUAL DFHRESP(NORMAL) PERFORM TRATA-ERRO. E este exemplo mostra atualização do ítem 10 da fila TS FATTS01. 10.9 Leitura de TS EXEC CICS READQ TS QUEUE (name) INTO (data-area) [LENGTH (data-area)] [ITEM (data-area) | NEXT] [NUMITENS(data-area)] END-EXEC. ___________________________________________________________________________________________ CICS – COBOL Command Level 74 O comando READQ TS é utilizado para leitura de filas TS. - A opção NEXT indica que estamos fazendo leitura sequencial da fila; - Se utilizarmos a opção ITEM estaremos fazendo leitura direta; - Se a opção NUMITENS for codificada, o CICS informa o número total de itens na fila. As data-areas dos campos ITEM e NUMITENS devem ser codificadas no programa com PIC S9(04) COMP. WORKING-STORAGE SECTION. 01 W-ITEM PIC S9(04) COMP. 03 TS-REG. ..... PROCEDURE DIVISION. EXEC CICS READQ TS QUEUE (‘FATTS01’) INTO (TS-REG) NEXT RESP (W-ERR) END-EXEC. IF W-ERR EQUAL DFHRESP(ITEMERR) EXEC CICS DELETEQ TS QUEUE(‘FATTS01’) END-EXEC ELSE IF W-ERR NOT EQUAL DFHRESP(NORMAL) PERFORM TRATA-ERRO. ...... Acima temos a leitura da fila FATTS01. Em seguida, se ocorrer a condição de fim de fila, a TS está sendo excluída através do comando DELETEQ TS.(abordado no próximo tópico). ___________________________________________________________________________________________ CICS – COBOL Command Level 75 10.10 Exclusão de TS EXEC CICS DELETEQ TS QUEUE (name) END-EXEC. O comando DELETEQ TS serve para excluir todos os itens de uma fila TS. É importante excluir fila após seu uso, principalmente se a fila foi gravada em memória. 10.11 Condições de exceção - TS � ITEMERR � LENGERR � NOSPACE � QIDERR � IOERR Condições de exceção a serem consideradas para TSs: - ITEMERR: Fim de fila ou ítem não encontrado; - LENGERR: Registro maior que o tamanho especificado; - NOSPACE: Não há espaço para gravação; - QIDERR: A fila TS não foi encontrada em uma leitura ou exclusão; - IOERR: Problemas com o arquivo. 11. UNIDADE 9 11.1 Manuseio de exceções É de extrema importância o manuseio de condições de exceção em programas executando sob CICS. Uma das técnicas é a chamada técnica estruturada, que temos utilizado desde o início dessa apostila. Codificamos a opção RESP nos comandos e em seguida testamos o campo utilizado como argumento. ___________________________________________________________________________________________ CICS – COBOL Command Level 76 Nessa unidade veremos as outras técnicas para manusear condições de exceção, e também o que são transações CECI e CEBR. 11.2 Manuseio de condições de exceção EXEC CICS HANDLE CONDITION Condition(label) Condition(label) ...... EXEC CICS IGNORE CONDITION Condition Condition ...... O comando HANDLE CONDITION serve para deixarmos pré-estabelecidas as rotinas para manuseio de condições de exceção. Podemos especificar até 16 condições, e ao executar um comando, se a condição ocorrer será feito um desvio automático para a rotina especificada no HANDLE CONDITION. O comando IGNORE CONDITION serve para o CICS ignorar as condições especificadas, e deixar o programa continuar. Serve também para resetar condições tratadas anteriormente em HANDLE CONDITION. PROCEDURE DIVISION. EXEC CICS HANDLE CONDITION INVREQ(TRATA-INV) LENGERR(TRATA-LENGTH) NOTFND(NÃO-ACHOU) PGMIDERR(TRATA-PROG) ERROR(TRATA-ERRO) END-EXEC. ...... EXEC CICS IGNORE CONDITION INVREQ ___________________________________________________________________________________________ CICS – COBOL Command Level 77 END-EXEC. ...... EXEC CICS READ FILE (‘TESTARQ’) INTO (W-REG) RIDFLD (W-CHAVE) END-EXEC. ...... NÃO-ACHOU. .... TRATA-LENGTH. ..... O exemplo acima mostra que o programa emitiu um HANDLE CONDITION com o nome de algumas rotinas para tratar condições de exceção específicas, e com a rotina TRATA-ERRO para o caso de uma condição não especificada. Em seguida, ele solicita que o CICS ignore a condição INVREQ através de um comando IGNORE CONDITION. Ao executar o comando READ, dependendo do que ocorrer o CICS fará um desvio para a rotina solicitada ou então deixará o programa prosseguir. 11.3 Opções para Manuseio de exceções - utilizar a opção RESP nos comandos, testando o campo da WORKING-STORAGE - utilizar a opção NOHANDLE nos comandos, e testar EIBRESP - utilizar HANDLE e IGNORE CONDITION - CICS toma ação Default, que geralmente é abendar a task. Uma das maneiras de tratar as condições de exceção é a que estamos utilizando desde o iníicio da apostila: codificar a opção RESP, e em seguida testar o campo utilizado como argumento. Outra forma estruturada de trabalhar é codificar a opção NOHANDLE nos comandos: o CICS deixará o programa prosseguir, e devemos testar o campo EIBRESP. ___________________________________________________________________________________________ CICS – COBOL Command Level 78 A utlização de HANDLE e IGNORE CONDITION quebra a estrutura do programa, portanto, não é aconselhada. Se não utilizarmos nenhuma das opções mostradas acima, no caso de exceções o CICS toma uma ação “default”, que geralmente é abendar a task. 11.4 EIBRESP2 para auxiliar INVREQ EIBRESP2 READ não especificado na FCT READ UPDATEnão especificado na FCT 20 KEYLENGTH incorreto e GENERIC não especificado 26 KEYLENGTH acima do permitido (GENERIC especificado) 25 KEYLENGTH NEGATIVO (GENERIC especificado) 42 READ UPDATE seguido de READ UPDATE sem UNLOCK, REWRITE or DELETE 28 A condição de exceção INVREQ (solicitação inválida – EIBRESP=16) é muito vaga, por isso o CICS traz o campo EIRESP2, que informa maiores detalhes do problema. 11.5 Manuseio de teclas WORKING-STORAGE SECTION. .... COPY DFHAID. .... PROCEDURE DIVISION. IF EIBAID EQUAL DFHPF3 ... IF EIBAID EQUAL DFHCLEAR PROCEDURE DIVISION. EXEC CICS HANDLE AID PF1(TRATA-HELP) PF3(TRATA-FIM) PF7(VOLTA-TELA) PF8(AVANÇA-TELA) PF10 ANYKEY(TECLA-INVALIDA) ___________________________________________________________________________________________ CICS – COBOL Command Level 79 ... IF EIBAID EQUAL DFHENTER ... END-EXEC. ..... TRATA-HELP. ..... TRATA-FIM. ...... VOLTA-TELA. ..... Para testar qual tecla foi pressionada pelo usuário, vimos a técnica estruturada, que consiste em copiar o copybook DFHAID na WORKING-STORAGE, e depois testar o campo EIBAID. Essa é a técnica recomendada. Existe também o comando HANDLE AID, onde especificamos teclas e para quais rotinas deve ocorrer o desvio. Esse desvio, ocorre após um comando RECEIVE ou RECEIVE MAP. A opção ANYKEY significa qualquer tecla com exceção do ENTER. Se utilizar HANDLE AID e o programa executar um RECEIVE com RESP ou NOHANDLE, o HANDLE AID será desabilitado naquele instante. 11.6 Cuidado ao utilizar HANDLE Se o CICS detecta uma tecla controlado por HANDLE AID e uma condição de exceção controlada por HANDLE CONDITION após um comando de input, o desvio é feito para a rotina do HANDLE AID. Abaixo mostramos uma condição em que a tecla PF5 foi pressionada e um MAPFAIL ocorreu. O desvio foi feito para a rotina TRATA-PF5. ___________________________________________________________________________________________ CICS – COBOL Command Level 80 PROCEDURE DIVISION. EXEC CICS HANDLE CONDITION MAPFAIL (TRATA-MAPFAIL) NOTFND (TRATA-NOTFND) LENGERR (TRATA-LENGTH) END-EXEC. ..... EXEC CICS HANDLE AID PF5 (TRATA-PF5) END-EXEC. .... TRATA-MAPFAIL. .... TRATA-PF5. .... 11.7 Comando HANDLE ABEND O comando HANDLE ABEND devolve o controle para o programa quando o CICS determina que a transação deveria terminar de forma anormal. Dessa forma, o programa pode realizar um “housekeeping” antes de seu término. EXEC CICS HANDLE ABEND [PROGRAM (name) | LABEL (label) | CANCEL | RESET] 11.8 Para suspender/restaurar HANDLEs O comando PUSH HANDLE suspende todos os HANDLEs que encontram-se ativos para o programa. ___________________________________________________________________________________________ CICS – COBOL Command Level 81 O comando POP HANDLE reativa os HANDLEs que foram suspensos. Devemos evitar utilizar esses comandos pois eles quebram a estrutura do programa, dificultando futuras manutenções. EXEC CICS SUSPENDE PUSH HANDLE TODOS EXEC CICS RESTAURA POP HANDLE TODOS Os comandos HANDLE são exclusivos de cada programa em uma task. Isso significa que se ocorrer um LINK, o programa chamado deverá ter seus próprios HANDLEs. Quando o controle volta para o programa chamador, seus HANDLEs são reativados. HANDLE CONDITION IGNORE CONDITION HANDLE ABEND HANDLE AID ___________________________________________________________________________________________ CICS – COBOL Command Level 82 11.9 CECI CECI – COMMAND LEVEL INTERPRETER A transação CECI é uma poderosa ferramenta que o CICS oferece para auxílio à programação. Com ela podemos verificar a sintaxe e executar quase todos os comandos EXEC CICS sem necessidade de escrever um programa. A figura acima mostra a tela inicial da CECI. STATUS: ENTER ONE OF THE FOLLOWING ABend DEQ INquire RECeive STARTBr ACquire DISAble ISsue RELease Suspend ADdress DISCard Journal RESEtbr SYncpoint ALlocate DUmp Link RESYnc Trace ASKtime ENAble LOad RETRieve Unlock ASSign ENDbr Monitor RETUrn Verify Bif ENQ PErform REWrite WAIT BUild ENTer POint ROute WAITCics CAncel EXtract POP SENd WRITE CHange FEpi POSt SET WRITEQ COLlect FOrmattime PURge SIGNOFf Xctl CONNect FREE PUSh SIGNON CONVerse FREEMain Query SPOOLClose CReate GDs READ SPOOLOpen DELAy GEtmain READNext SPOOLRead DELETE Handle READPrev SPOOLWrite DELETEQ IGnore READQ START PF 1 HELP 2 HEX 3 END 4 EIB 5 VAR 6 USER 9MSG ___________________________________________________________________________________________ CICS – COBOL Command Level 83 O exemplo mostra a gravação de um ítem na TS FATTS1 utilizando a CECI. A CECI mostra o comando antes de ser executado (ABOUT TO EXECUTE COMMAND). A seguir veremos o resultado da execução. WRITEQ TS Q(FATTS1) FROM (‘TESTE GRAVACAO DE TS’) STATUS: ABOUT TO EXECUTE COMMAND NAME= EXEC CICS WRITEQ TS Queue(‘FATTS1 ‘) From(‘TESTE DE GRAVACAO DE TS’) > PF 1 HELP 2 HEX 3 END 4 EIB 5 VAR 6 USER 9MSG ___________________________________________________________________________________________ CICS – COBOL Command Level 84 A figura mostra que o comando teve Response=Normal portanto a TS foi realmente gravada. A CECI é muito útil quando precisamos corrigir registros em arquivos ou mesmo para criar registros para teste de algumas aplicações. WRITEQ TS Q(FATTS1) FROM (‘TESTE GRAVACAO DE TS’) STATUS: ABOUT TO EXECUTE COMMAND NAME= EXEC CICS WRITEQ TS Queue(‘FATTS1 ‘) From(‘TESTE DE GRAVACAO DE TS’) > RESPONSE:NORMAL EIBRESP=+0000000000 EIBRESP2=+0000000000 PF 1 HELP 2 HEX 3 END 4 EIB 5 VAR 6 USER 7SBH 8 SFH 9 MSG 10 SB 11 SF ___________________________________________________________________________________________ CICS – COBOL Command Level 85 11.10 CEBR CEBR – BROWSE TEMPORARY STORAGE / TRANSIENT DATA A transação CEBR permite fazer consulta em filas TS e TD, com uma série de facilidades. Através da PF1 (HELP), temos uma lista de comandos que podemos utilizar para consultar o conteúdo completo de filas. CEBR TS QUEUE CEBRT001 RECORD 1 OF 0 COL 1 OF 0 ENTER COMMAND � ******************* TOP OF QUEUE ************************ ***************** BOTTOM OF QUEUE ********************** TEMPORARY STORAGE QUEUE CEBRT001 DOES NOT EXIST PF1:HELP PF2:SWITCH HEX/CHAR PF3:TERMINATE BROWSE PF4:VIEW TOP PF5:VIEW BOTTOM PF6:REPEAT LAST FIND PF7:SCROLL BACK HALF PF8:SCROLL FORWARD HALF PF9:UNDEFINED PF10:SCROLL BACK FULL PF11:SCROLL FORWARD FULL PF12:UNDEFINED ___________________________________________________________________________________________ CICS – COBOL Command Level86 12. UNIDADE 10 12.1 CEDF – EXECUTION DIAGNOSTIC FACILITY O CEDF é uma transação fornecida com o CICS que facilita muito o trabalho de quem está testando novas aplicações ou necessita fazer uma determinação de problemas online e interativa. É uma ferramenta com muitos recursos, os quais mostraremos nessa unidade. É muito fácil utilizá-la. Basta digitar CEDF no terminal e pressionar a tecla ENTER. Em seguida surgirá a mensagem informando que o terminal está em EDF. A partir daí é só limpar a tela e chamar a transação para acompanhar sua execução. O CEDF mostrará cada comando EXEC CICS da aplicação com uma série de facilidades. TRANSACTION:UPDT PROGRAM:UPDTPGM TASK:0000038 APPLID:CICTST1 DISPLAY:00 STATUS: PROGRAM INITIATION EIBTIME = 192146 EIBDATE = 02180 EIBTRNID = ‘UPDT’ EIBTASKN = 38 EIBTRMID = ‘4601’ EIBCPOSN = 4 EIBCALEN = 0 EIBAID = X’7D’ AT X’001400EA’ EIBFN = X’0000’ AT X’001400EB’ EIBRCODE = X’000000000000’ AT X’001400ED’ EIBDS = ‘........’ + EIBREQID = ‘........’ ENTER: CONTINUE PF1:UNDEFINED PF2:SWITCH HEX/CHAR PF3:END EDF SESSION PF4:SUPPRESS DISPLAYS PF5:WORKING STORAGE PF6:USER DISPLAY PF7:SCROLL BACK PF8:SCROLL FORWARD PF9:STOP CONDITIONS PF10:PREVIOUS DISPLAY PF11:UNDEFINED PF12:UNDEFINED ___________________________________________________________________________________________ CICS – COBOL Command Level 87 A figura anterior é a primeira tela que o CEDF mostra. Note que temos uma série de informações logo na primeira linha: nome da transação, nome do programa, número da task. O STATUS indica que está em PROGRAM INITIATION. Em seguida, o CEDF traz os valores iniciais do EIB (Exec Interface Block) para essa task. 12.2 CEDF – alteração de argumentos O CEDF sempre mostra o comando antes de executar (STATUS: ABOUT TO EXECUTE COMMAND) e após a execução (STATUS: COMMAND EXECUTION COMPLETE). TRANSACTION:UPDT PROGRAM:UPDTPGM TASK:0000038 APPLID:CICTST1 DISPLAY:00 STATUS: ABOUT TO EXECUTE COMMAND EXEC CICS READ FILE(‘ARQ01’) INTO(‘ ‘...) LENGTH(91) RIDFLD(‘000010’) EQUAL NOHANDLE OFFSET:X’00073E’ LINE:00206 EIBFN=X’0602’ ENTER: CONTINUE PF1:UNDEFINED PF2:SWITCH HEX/CHAR PF3:UNDEFINED PF4:SUPPRESS DISPLAYS PF5:WORKING STORAGE PF6:USER DISPLAY PF7:SCROLL BACK PF8:SCROLL FORWARD PF9:STOP CONDITIONS PF10:PREVIOUS DISPLAY PF11:UNDEFINED PF12:ABEND USER TASK ___________________________________________________________________________________________ CICS – COBOL Command Level 88 Permite ainda a alteração de alguns valores de argumentos antes de executar o comando, facilitando bastante o processo de teste de uma aplicação. 12.3 CEDF – alteração de response codes O CEDF mostra a execução do comando e informa o RESPONSE. Podemos alterar esse response para qualquer valor válido, com o objetivo de testar rotinas que fazem tratamento de erros no programa. TRANSACTION:UPDT PROGRAM:UPDTPGM TASK:0000038 APPLID:CICTST1 DISPLAY:00 STATUS: COMMAND EXECUTION COMPLETE EXEC CICS READ FILE(‘ARQ01’) INTO(‘ ‘...) LENGTH(91) RIDFLD(‘000010’) EQUAL NOHANDLE OFFSET:X’00073E’ LINE:00206 EIBFN=X’0602’ RESPONSE: NOTFND ENTER: CONTINUE PF1:UNDEFINED PF2:SWITCH HEX/CHAR PF3:END EDF SESSION PF4:SUPPRESS DISPLAYS PF5:WORKING STORAGE PF6:USER DISPLAY PF7:SCROLL BACK PF8:SCROLL FORWARD PF9:STOP CONDITIONS PF10:PREVIOUS DISPLAY PF11:UNDEFINED PF12:ABEND USER TASK ___________________________________________________________________________________________ CICS – COBOL Command Level 89 12.4 CEDF – line number e offset Outra facilidade do CEDF é exibir a linha onde encontra-se esse comando na listagem do programa fonte gerada pelo Translator durante a compilação (LINE). Também mostra o deslocamento desse comando a partir do início do programa(OFFSET). Isso facilita a localização do comando no programa fonte. 12.5 Facilidades do CEDF 12.5.1 CEDF - hexadecimal Com a tecla PF2 podemos fazer a conversão dos argumentos para formato hexadecimal. Com esse procedimento, o CEDF exibe também o endereço de memória onde esses argumentos estão localizados. TRANSACTION:UPDT PROGRAM:UPDTPGM TASK:0000046 APPLID:CICTST1 DISPLAY:00 STATUS: ABOUT TO EXECUTE COMMAND EXEC CICS SEND MAP MAP(‘TESTMP’) FROM(‘................%................%........................’...) LENGTH(314) MAPSET(‘TESTMS1’) TERMINAL FREEKB ERASE OFFSET:X’000AB8’ LINE:00319 EIBFN=X’1804’ ENTER: CONTINUE PF1:UNDEFINED PF2:SWITCH HEX/CHAR PF3:UNDEFINED PF4:SUPPRESS DISPLAYS PF5:WORKING STORAGE PF6:USER DISPLAY PF7:SCROLL BACK PF8:SCROLL FORWARD PF9:STOP CONDITIONS PF10:PREVIOUS DISPLAY PF11:UNDEFINED PF12:ABEND USER TASK ___________________________________________________________________________________________ CICS – COBOL Command Level 90 12.5.2 CEDF – WORKING STORAGE Pressionando a tecla PF5 no Menu Principal do CEDF, temos acesso à WORKING do programa. Além de exibir todos os campos da WORKING, é permitido alterar o conteúdo desses campos. Além da WORKING, podemos verificar o conteúdo de qualquer endereço de memória dentro do CICS. Basta posicionar o cursor no campo ADDRESS e informar o endereço desejado. 12.5.3 CEDF – Exec Interface Block A qualquer instante, temos acesso ao EIB. Basta pressionar PF5 (WORKING- STORAGE) e depois PF4 (EIB Display). 12.5.4 CEDF – Stop conditions Se não desejamos acompanhar a execução da task comando por comando, temos a possibilidade de definir condições de parada (STOP CONDITIONS) através da PF9. Após definir as condições, a tecla PF4 (SUPPRESS DISPLAYS) vai fazer com que os comandos anteriores ao solicitado não sejam exibidos no CEDF. 12.5.5 CEDF – Previous Display O CEDF permite visualização de até 10 painéis anteriores, se tivermos necessidade de rever algum comando que já foi executado. Isso é feito através da tecla PF10 (PREVIOUS DISPLAY). O campo DISPLAY (1ª linha da tela do lado direito) mostrará um valor negativo, indicando quel tela está sendo exibida. 12.5.6 CEDF – pseudo-conversação Podemos acompanhar as várias tasks de uma pseudo-conversação com o CEDF. No final da task, é feita a pergunta se queremos acompanhar a próxima execução. (REPLY: YES/NO). 12.5.7 CEDF – solicitando Abend Podemos solicitar o ABEND da task que está sendo monitorada pelo CEDFatravés da PF12. Será solicitado um código de ABEND, e em seguida a PF12 deve ser pressionada novamente.7.6 Atualização VSAM .......................................................................................................45 7.7 Atualização de um registro ..........................................................................................45 7.8 Exclusão de registro(s) .................................................................................................46 7.9 Liberação de registro ...................................................................................................47 7.10 Condições de exceção ...............................................................................................47 7.11 Codificação - atualização .........................................................................................48 7.12 Desenho Conversacional ..........................................................................................48 7.13 Desenho Pseudo-conversacional..............................................................................49 7.14 Gravação de registros - WRITE .............................................................................50 ___________________________________________________________________________________________ CICS – COBOL Command Level 4 8. UNIDADE 6 .................................................................................................. 52 8.1 Controle de programas ................................................................................................52 8.2 Link entre programas ..................................................................................................52 8.3 Passagem de Dados Usando LINK..............................................................................52 8.4 Níveis lógicos - LINK....................................................................................................53 8.5 XCTL entre programas ...............................................................................................54 8.6 Passagem de dados usando XCTL ..............................................................................54 8.7 Níveis lógicos - XCTL..................................................................................................55 8.8 Cuidados com a LINKAGE SECTION......................................................................56 8.9 Call estático – COBOL.................................................................................................56 8.10 Call dinâmico – COBOL..........................................................................................57 8.11 Passagem de dados com INPUTMSG.....................................................................58 9. UNIDADE 7 .................................................................................................. 60 9.1 Addressability – uso da LINKAGE SECTION .........................................................60 9.2 Addressability ...............................................................................................................60 9.3 BLL Cells – OS/VS cobol .............................................................................................61 9.4 Opção SET – utiliza LINKAGE SECTION...............................................................62 9.5 Tabelas em Assembler..................................................................................................62 9.6 Carga de tabelas COBOL II -LOAD..........................................................................63 9.7 Adquirindo memória – COBOL II .............................................................................64 9.8 Áreas maiores que 4096 – COBOL II.........................................................................65 9.9 Acessando a Common Work Area (CWA) ................................................................65 10. UNIDADE 8 .................................................................................................. 67 10.1 Queueing....................................................................................................................67 10.2 Transient Data - TD .................................................................................................67 10.2.1 TD Intrapartition.....................................................................................................67 10.2.2 TD Extrapartition....................................................................................................68 10.3 Gravação de TD........................................................................................................69 10.4 Leitura de TD............................................................................................................69 10.5 Exclusão de TD .........................................................................................................70 10.6 Condições de exceção - TD.......................................................................................70 10.7 Temporary Storage - TS ..........................................................................................71 10.8 Gravação de TS.........................................................................................................72 10.9 Leitura de TS ...........................................................................................................73 10.10 Exclusão de TS..........................................................................................................75 ___________________________________________________________________________________________ CICS – COBOL Command Level 5 10.11 Condições de exceção - TS .......................................................................................75 11. UNIDADE 9 .................................................................................................. 75 11.1 Manuseio de exceções ...............................................................................................75 11.2 Manuseio de condições de exceção..........................................................................76 11.3 Opções para Manuseio de exceções.........................................................................77 11.4 EIBRESP2 para auxiliar..........................................................................................78 11.5 Manuseio de teclas....................................................................................................78 11.6 Cuidado ao utilizar HANDLE.................................................................................79 11.7 Comando HANDLE ABEND ..................................................................................80 11.8 Para suspender/restaurar HANDLEs.....................................................................80 11.9 CECI ..........................................................................................................................82 11.10 CEBR.........................................................................................................................85 12. UNIDADE 10 ................................................................................................ 86 12.1 CEDF – EXECUTION DIAGNOSTIC FACILITY.......... ....................................86 12.2 CEDF – alteração de argumentos ...........................................................................87 12.3 CEDF – alteração de response codes ......................................................................88 12.4 CEDF – line number e offset ...................................................................................89 12.5 Facilidades do CEDF................................................................................................89 12.5.1 CEDF - hexadecimal ..............................................................................................89 12.5.2 CEDF – WORKING STORAGE ...........................................................................9012.5.3 CEDF – Exec Interface Block ................................................................................90 12.5.4 CEDF – Stop conditions.........................................................................................90 12.5.5 CEDF – Previous Display ......................................................................................90 12.5.6 CEDF – pseudo-conversação .................................................................................90 12.5.7 CEDF – solicitando Abend.....................................................................................90 13. Bibliografia ........................................................Erro! Indicador não definido. ___________________________________________________________________________________________ CICS – COBOL Command Level 6 1. Legenda dos Componentes Orientativos. DICA LEIA TOME NOTA ATENÇÃO CURIOSIDADE ___________________________________________________________________________________________ CICS – COBOL Command Level 7 2. Introdução Este curso oferece uma visão geral de programação CICS, conceitos e comandos. Ao final deste curso você estará apto a desenvolver programas CICS. ___________________________________________________________________________________________ CICS – COBOL Command Level 8 3. UNIDADE 1 3.1 Conceitos fundamentais e pseudo-conversação O que é CICS? Para que serve? Como desenvolver aplicações? Nessa primeira unidade veremos conceitos fundamentais para conhecermos um pouco do produto CICS, assim como a sintaxe dos comandos necessários para desenvolver uma aplicação COBOL/CICS. Também aprenderemos o conceito de programação Pseudo-conversacional, a forma mais moderna e vantajosa de desenvolver aplicativos sob CICS. 3.2 Customer Information Control System O CICS é um produto que foi criado em 1968 e transformado em programa- produto IBM em 1969, na sua primeira versão. Trata-se de um monitor transacional Online, ou seja, um produto que gerencia a execução de aplicações em tempo real. O CICS é um produto multi-usuário e multi-task (multi-tarefa), portanto permite a execução concorrente de inúmeras aplicações de uma grande quantidade de usuários. O CICS é composto de quatro áreas: PCT – tabela de controle de transações TCT – tabela de controle de terminais PPT – tabela de controle de programas FCT – tabela de controle de arquivos VSAM 3.3 A comunicação entre CICS Podemos ter uma única região de CICS se tivermos uma carga de trabalho pequena, mas caso a empresa tenha um alto número de usuários e muito processamento online a ser executado diariamente, podemos ter diversas regiões CICS trabalhando e distribuindo a carga através de facilidades de comunicação. Um CICS pode comunicar-se com outros CICS residentes na mesma CPU, em CPUs diferentes e mesmo em localidades diversas do planeta, facilitando muito o processamento distribuído. ___________________________________________________________________________________________ CICS – COBOL Command Level 9 3.4 Conceitos Dois conceitos fundamentais para trabalhar com o CICS: Transação: é o código de 1 a 4 caracteres definido na PCT (program control table) do CICS, e que representa o processo de uma aplicação. Uma transação sempre fica amarrada a um programa de aplicação, que é o processado quando a transação é executada. Quase sempre a transação trabalha associada a um terminal, já que o CICS é um produto que processa aplicações em tempo real. Esse terminal é denominado “terminal associado à transação”. Task: é a unidade de trabalho do CICS, ou para ser mais exato, é a execução de uma transação. Podemos ter diversos usuários executando a mesma transação em vários terminais. Cada execução é denominada Task. 3.5 Executando transações Quando o usuário chama uma transação a partir de um terminal conectado ao CICS, imediatamente é verificado se essa transação está cadastrada na tabela PCT. Se estiver, um bloco de controle denominado TCA (Task Control Area) é criado e vai existir durante a execução da task. Através da PCT o CICS sabe qual o programa associado à transação, e verifica se esse programa está cadastrado na tabela PPT (Processing Program Table). Se estiver tudo o.k., a task é executada. 3.6 Execução concorrente de tasks Como dissemos, para cada execução de transação (task), é criado um bloco de controle chamado TCA. Portanto, se tivermos várias tasks da mesma transação, teremos várias TCAs, uma para cada task. Entretanto, o CICS não carrega na memória várias cópias de um mesmo programa. Apenas uma cópia do programa é carregada e utilizada por todas as tasks. A WORKING-STORAGE tem que ter uma cópia para cada task, já que ela é utilizada com dados diferentes para cada usuário. A TCA é o ponto focal da task, já que todas as áreas são encadeadas a partir dela. Cada task terá também uma área denominada EIB (Exec Interface Block), que traz uma série de informações muito úteis para nossos programas. ___________________________________________________________________________________________ CICS – COBOL Command Level 10 3.7 Formato dos comandos EXEC CICS RECEIVE INTO(FLDA) LENGTH(W-LEN) END-EXEC 1 2 3 4 5 6 7 1 -> KEYWORDS 2 -> FUNÇÃO 3 -> OPÇÃO 4 -> ARGUMENTO 5 -> OPÇÃO 6 -> ARGUMENTO 7 -> DELIMITADOR Um comando CICS é formado pela estrutura mostrada acima: - As keywords EXEC CICS - A função solicitada (send, receive, ...) - As opções com seus respectivos argumentos - Para COBOL, o delimitador END-EXEC. 3.8 Argumentos Data-value Pic s9(04) comp Pic s9(08) comp Pic x(15) Constantes permitidas Data-area COBOL data name Não constante Name COBOL data name ___________________________________________________________________________________________ CICS – COBOL Command Level 11 Constantes permitidas Label Nome de parágrafo Hhmmss Pic s9(07) comp-3 Pointer-ref BLL cell Usage pointer O quadro acima mostra os diferentes tipos de dados no Cobol para cada tipo de argumento dos comandos CICS. 3.9 Comandos básicos • Comandos de terminal control - SEND - RECEIVE • Comandos de formatação de data e hora - ASKTIME - FORMATTIME • Comandos de término de programa - RETURN 3.9.1 Comando RECEIVE WORKING-STORAGE SECTION. 77 W-LEN PIC S9(04) COMP. 01 AREA-INPUT. 02 COD-TRANS PIC X(04). 02 FILLER PIC X(01). 02 SOLICIT PIC X(04). ..................... ___________________________________________________________________________________________ CICS – COBOL Command Level 12 PROCEDURE DIVISION. MOVE 9 TO W-LEN EXEC CICS RECEIVE INTO(AREA-INPUT) LENGTH(W-LEN) END-EXEC. O comando RECEIVE serve para trazer para a memória do CICS e do programa os dados que foram digitados pelo usuário no terminal. Os dados normalmente são recebidos na WORKING-STORAGE do programa. A opção LENGTH especifica o tamanho máximo permitido para a recepção dos dados. A partir do COBOL II, o LENGTH deixou de ser necessário. O Cobol assume que o tamanho máximo dos dados é o tamanho da área especificada na opção INTO. 3.9.1.1 Condições de Exceção - RESP WORKING-STORAGE SECTION. 77 W-LEN PIC S9(04) COMP. 77 W-ERR PIC S9(08) COMP. 01 AREA-INPUT. 02 COD-TRANS PIC X(04). 02 FILLER PIC X(01). 02 SOLICIT PIC X(04). 01 MSG PIC X(80). .................... PROCEDURE DIVISION. MOVE 9 TO W-LEN EXEC CICS RECEIVE INTO (AREA-INPUT)LENGTH (W-LEN) RESP (W-ERR) END-EXEC. ___________________________________________________________________________________________ CICS – COBOL Command Level 13 IF W-ERR EQUAL DFHRESP(LENGERR) MOVE ‘MAX 9 CARACTERES’ TO MSG ..... A opção RESP nos comandos faz com que o CICS não manuseie as condições de exceção. O CICS simplesmente armazena no campo indicado o tipo de exceção e o programa deve verificar se o comando obteve sucesso ou não. É EXTREMAMENTE IMPORTANTE VERIFICAR EXCEÇÕES EM COMANDOS CICS. 3.9.2 Comando SEND WORKING-STORAGE SECTION. 77 W-LEN PIC S9(04) COMP. 77 W-ERR PIC S9(08) COMP. 03 AREA-INPUT. 04 COD-TRANS PIC X(04). 02 FILLER PIC X(01). 02 SOLICIT PIC X(04). 01 MSG PIC X(80). ................................ PROCEDURE DIVISION. MOVE 9 TO W-LEN EXEC CICS RECEIVE INTO (AREA-INPUT) LENGTH (W-LEN) RESP (W-ERR) END-EXEC. IF W-ERR EQUAL DFHRESP(LENGERR) MOVE ‘MAX 9 CARACTERES’ TO MSG EXEC CICS SEND FROM (MSG) ___________________________________________________________________________________________ CICS – COBOL Command Level 14 LENGTH (50) END-EXEC EXEC CICS RETURN END-EXEC. O comando SEND serve para enviar dados ao terminal do usuário. A informação é gravada na tela do terminal a partir do ponto onde o cursor ficou posicionado. O comando RETURN serve para terminar a aplicação e devolver o controle ao CICS. 3.9.3 Posicionamento de Cursor WORKING-STORAGE SECTION. 77 W-LEN PIC S9(04) COMP. 77 W-ERR PIC S9(08) COMP. 01 AREA-INPUT. 02 COD-TRANS PIC X(04). 02 FILLER PIC X(01). 02 SOLICIT PIC X(04). 01 MSG PIC X(80). ...................... PROCEDURE DIVISION. MOVE 9 TO W-LEN EXEC CICS RECEIVE INTO (AREA-INPUT) LENGTH (W-LEN) RESP (W-ERR) END-EXEC. IF W-ERR EQUAL DFHRESP(LENGERR) MOVE ‘MAX 9 CARACTERES’ TO MSG EXEC CICS SEND CONTROL CURSOR(1840) END-EXEC EXEC CICS SEND FROM (MSG) LENGTH (50) ___________________________________________________________________________________________ CICS – COBOL Command Level 15 END-EXEC EXEC CICS RETURN END-EXEC. O comando SEND CONTROL está sendo utilizado nesse momento para posicionar o cursor na primeira posição da linha 24 do terminal, já que normalmente uma tela de terminal tem 24 x 80 (1920 posições). Portanto, a mensagem enviada pelo comando SEND ficará posicionada na linha 24 do terminal do usuário. 3.9.4 Formatação de Data e Hora WORKING-STORAGE SECTION. 77 W-LEN PIC S9(04) COMP. 77 W-ERR PIC S9(08) COMP. 77 W-ABS PIC S9(15) COMP-3. 01 W-DATA-S. 02 FILLER PIC X(30) VALUE ‘DATA DE HOJE: ‘. 02 W-DATA PIC X(08). 01 W-HORA-S. 02 FILLER PIC X(30) VALUE ‘HORA CERTA: ‘. 02 W-HORA PIC X(08). 01 AREA-INPUT. 02 COD-TRANS PIC X(04). 02 FILLER PIC X(01). 02 SOLICIT PIC X(04). 01 MSG PIC X(80). .................... PROCEDURE DIVISION. MOVE 9 TO W-LEN EXEC CICS RECEIVE INTO (AREA-INPUT) LENGTH (W-LEN) RESP (W-ERR) END-EXEC. IF W-ERR EQUAL DFHRESP(LENGERR) MOVE ‘MAX 9 CARACTERES’ TO MSG EXEC CICS SEND CONTROL CURSOR(1840) END-EXEC EXEC CICS SEND FROM (MSG) LENGTH (50) END-EXEC EXEC CICS RETURN END-EXEC. ___________________________________________________________________________________________ CICS – COBOL Command Level 16 IF SOLICIT EQUAL ‘DATA’ EXEC CICS ASKTIME ABSTIME (W-ABS) END-EXEC EXEC CICS FORMATTIME ABSTIME (W-ABS) DATESEP DDMMYY (W-DATA) END-EXEC EXEC CICS SEND CONTROL CURSOR(1840) END-EXEC EXEC CICS SEND FROM (W-DATA-S) LENGTH (40) END-EXEC EXEC CICS RETURN END-EXEC. IF SOLICIT EQUAL ‘HORA’ EXEC CICS ASKTIME ABSTIME (W-ABS) END-EXEC EXEC CICS FORMATTIME ABSTIME (W-ABS) TIMESEP TIME (W-HORA) END-EXEC EXEC CICS SEND FROM (W-HORA-S) LENGTH (40) END-EXEC EXEC CICS RETURN END-EXEC. A aplicação receberá o tipo de solicitação do usuário, processará conforme for a necessidade e devolverá a resposta ao terminal. Portanto, uma típica (embora simples) aplicação CICS: recebe a solicitação, processa, devolve a resposta para o usuário e termina. O comando ASKTIME informa ao programa o momento exato, e a partir daí podemos utilizar o FORMATTIME para editar a data e hora de acordo com a preferência do usuário. Datesep: faz a separação com ‘/’ da data. Se colocarmos argumento DATESEP (‘.’) para a separação, formatará a data dd.mm.yyyy ___________________________________________________________________________________________ CICS – COBOL Command Level 17 3.10 Exec Interface Block (EIB) EIBTIME Hora EIBDATE Data (juliano) EIBCPOSN Posição do cursor EIBAID Tecla pressionada (enter, pf, ...) EIBCALEN Tamanho da commarea EIBTRNID Código da transação EIBTRMID Terminal associado EIBFN Última função executada EIBRESP Response code . . O EIB (Exec Interface Block) é uma área que fica na LINKAGE SECTION de nosso programa e traz uma série de informações que podem e devem ser utilizadas a qualquer momento para facilitar nosso trabalho. Acima, estão algumas das informações que constam do EIB. 3.11 Compilação de Programas Para preparar um programa COBOL/CICS, são necessárias três fases na PROCEDURE de compilação: - Transalator: é um pré-processador fornecido com o CICS, e que serve para traduzir os comandos EXEC CICS para MOVEs e CALLs, já que o compilador Cobol não reconhece EXEC CICS. O translator também inclui algumas áreas de trabalho na WORKING e na LINKAGE, entre elas o EIB; - Compilador Cobol: para compilar o programa; - Linkage Editor: transforma em módulo executável e cataloga em uma biblioteca de programas. 3.12 Conversacional x Pseudo-conversacional Existem duas formas de programação sob CICS: - Conversacional: é uma técnica antiga que praticamente não está sendo utilizada, uma vez que consome muitos recursos do sistema, e vai contra a filosofia do CICS, que é de aplicações que processem rapidamente e consumam poucos recursos. Essa técnica consiste em processar os dados recebidos do usuário, devolver a resposta, e aguardar para receber novas solicitações. ___________________________________________________________________________________________ CICS – COBOL Command Level 18 - Pseudo-Conversacional: é a técnica mais utilizada, mais moderna e mais eficiente de programação. A aplicação recebe a solicitação do usuário, processa, envia a resposta e termina, liberando praticamente todos os recursos. Ao terminar, a aplicação encadeia uma nova execução da transação, como veremos a seguir. 3.13 Pseudo-conversacional Após enviar a resposta ao usuário (SEND), o programa termina através do comando RETURN, encadeando uma nova execução da mesma transação – TRANSID (‘FAT1’). Isso significa que a task terminará, os recursos serão liberados, mas quando o usuário teclar ENTER, PFs, PAs, ou CLEAR, uma nova task da mesma transação será executada. Portanto, o usuário terá a sensação de uma conversação, mas estará ocorrendo uma pseudo-conversação. 3.14 Passagem de dados para próxima task Para enviar dados para a próxima task, utilizamos uma área de comunicação chamada COMMAREA. Essa área será passada através de uma área de WORKING-STORAGE no programa e pode ter qualquer nome. Na próxima execução, os dados passados serão recebidos em uma área reservada do programa, localizadana LINKAGE SECTION e chamada DFHCOMMAREA (nome reservado). A área transmitida deve ter o mesmo tamanho em sua recepção na DFHCOMMAREA. Na primeira execução da transação não podemos utilizar a DFHCOMMAREA, pois ela ainda não existe. Ela existirá a partir da segunda execução, com os dados recebidos. Como saberemos se estamos processando a transação pela primeira vez? A resposta para esta importante questão está em um campo do EIB denominado EIBCALEN (Commarea Length). Na primeira execução da transação, o EIBCALEN estará com valor zero, e nas demais execuções estará maior que zero. 3.15 Pseudo-Conversacional – utilizando commarea IDENTIFICATION DIVISION. PROGRAM-ID. FAT1PGM. WORKING-STORAGE SECTION. 01 W-COMM. 02 CH1 PIC X(01) VALUE ‘N’. 02 QTD PIC 9(09). LINKAGE SECTION. 01 DFHCOMMAREA. 02 L-CH1 PIC X(01). 02 L-QTD PIC 9(09). PROCEDURE DIVISION. IF EIBCALEN EQUAL ZEROS MOVE 5000 TO QTD EXEC CICS RETURN TRANSID (‘FAT1’) ___________________________________________________________________________________________ CICS – COBOL Command Level 19 COMMAREA (W-COMM) LENGTH (10) END-EXEC. MOVE L-CH1 TO ..... MOVE L-QTD TO ..... Na primeira execução, não existe a DFHCOMMAREA, portanto, o EIBCALEN estará zerado, e passaremos dados através de uma área de WORKING- STORAGE. A partir da segunda execução, teremos DFHCOMMAREA, portanto podemos utilizar os dados recebidos na DFHCOMMAREA. Dessa forma conseguimos comunicação total entre as tasks da mesma transação executadas pelo usuário. COMMAREA x DFHCOMMAREA A chave da pseudo-conversação esta na Communication Area. Na primeira execução � EIBCALEN zero � utilizar Commarea na WORKING-STORAGE para passagem de dados. Nas demais execuções � EIBCALEN maior que zero � dados recebidos em LINKAGE SECTION na DFHCOMMAREA. 3.16 COBOL sob CICS – Restrições IDENTIFICATION DIVISION. PROGRAM-ID. ENVIRONMENT DIVISION. CONFIGURATION SECTION. XXXX INPUT-OUTPUT SECTION. DATA DIVISION. XXXX FILE SECTION. WORKING-STORAGE SECTION. LINKAGE SECTION. PROCEDURE DIVISION. ___________________________________________________________________________________________ CICS – COBOL Command Level 20 Sob CICS não utilizamos INPUT-OUTPUT SECTION e FILE SECTION. Quem gerencia os arquivos é o CICS, e não o programa de aplicação. COBOL II OS/COBOL ACCEPT ACCEPT DISPLAY DISPLAY CLOSE EXAMINE OPEN EXHIBIT READ STOP RUN WRITE INSPECT REWRITE STRING DELETE TIME TRANSFORM UNSTRING CLOSE OPEN READ WRITE Sob CICS não podemos utilizar instruções COBOL que solicitem serviço direto ao Sistema Operacional. Após executarmos uma transação no CICS, caso tenha ocorrido alguma modificação no programa de aplicação e ele tenha sido recompilado, teremos que informar ao CICS que uma nova cópia deve ser carregada na memória. Para tanto, utilizamos a transação de Master Terminal – CEMT. CEMT SET PROG(name) NEWCOPY OU CEMT SET PROG(name) PHASEIN ___________________________________________________________________________________________ CICS – COBOL Command Level 21 4. UNIDADE 2 4.1 BASIC MAPPING SUPPORT Nessa unidade veremos mapas, que são telas de terminal compostas de diversos campos de dados formatados, isto é, com posição fixa na tela. Através dos mapas torna-se muito mais simples trabalharmos com apresentação de dados ao usuário através de nossos programas de aplicação. A facilidade que o CICS fornece para trabalharmos com mapas chama-se BMS (Basic Mapping Support). Basic Mapping Support (BMS) - utiliza dados formatados (mapas) - campos constantes e variáveis - interface muito mais atrativa para o usuário Um mapa normalmente é composto por campos constantes e variáveis, que fazem uma interface bastante atrativa para o usuário final. Cada campo tem atributos próprios, visando facilitar o trabalho do usuário. 4.2 Definição de mapas Para decidir como serão os mapas (telas de terminal) de determinada aplicação CICS, é necessário que o analista responsável pela aplicação faça uma reunião com os usuários finais, a fim de saber quais são suas necessidades de informações. A partir desse ponto, será necessário fazer a definição dos mapas seguida de sua geração. 4.3 Campos 3270 1 2 3 4 5 6 . . . . 24 NOME: ENDEREÇO: CPF: NO. CONTA: stopper (delimitador) ___________________________________________________________________________________________ CICS – COBOL Command Level 22 Um mapa é composto por campos formatados 3270. Cada campo tem uma posição fixa no buffer do terminal (tela), e é delimitado por atributos. Um atributo ocupa o espaço de um byte na tela do terminal, mas seu conteúdo não é visível, já que estamos tratando do controle das características do campo. 4.4 Campos formatados 3270 campos Posic. cursor protegidos delimitadores A figura acima mostra o exemplo de um mapa. Esse mapa é formado por constantes e variáveis, e cada campo tem seu atributo. Os campos constantes geralmente tem atributo protegido. Os campos variáveis, quando servirem para entrada de dados, devem ter atributo desprotegido. Os campos numéricos necessitam ter atributo numérico, para impedir que o usuário digite caracteres não numéricos. Os delimitadores são campos de 1 byte, compostos apenas pelo atributo “askip”, e servem para delimitar o tamanho do campo onde o usuário digitará informações. ATRIBUTOS: - UNPROTECTED/PROTECTED (UNPROT/PROT): usuário pode ou não digitar informações. - ASKIP: campo protegido e o cursor não pode ser posicionado nele. - NUM: dependendo do hardware, permite ao usuário digitar apenas dados numéricos. NOME: _ CPF: NO. CONTA: constantes numeric fields campos protegidos ___________________________________________________________________________________________ CICS – COBOL Command Level 23 - NORMAL/BRIGHT/DARK (NO/BRT/DRK): campo com intensidade normal, brilhante ou invisível. - MDT ON/OFF: se o MDT (Modified Data Tag) de um campo estiver ligado, o conteúdo desse campo será transmitido para o programa. Se estiver desligado, o conteúdo não será transmitido para o pgm. 4.5 Definindo um mapa TESTMS1 DFHMSD TYPE=&SYSPARM,MODE=INOUT,LANG=COBOL X TIOAPFX=YES,STORAGE=AUTO TESTMP DFHMDI SIZE=(24,80),LINE=1,COLUMN=1 DFHMDF POS=(3,1),LENGTH=5,INITIAL=’NOME:’,ATTRIB=ASKIP NOME DFHMDF POS=(3,7),LENGTH=30,ATTRIB=(UNPROT,IC) DFHMDF POS=(3,38),LENGTH=1,ATTRIB=ASKIP DFHMDF POS=(5,1),LENGTH=4,INITIAL=’END:’,ATTRIB=ASKIP ENDER DFHMDF POS=(5,6),LENGTH=40,ATTRIB=UNPROT DFHMDF POS=(5,47),LENGTH=1,ATTRIB=ASKIP DFHMDF POS=(7,1),LENGTH=4,INITIAL=’CPF:’,ATTRIB=ASKIP CPF DFHMDF POS=(7,6),LENGTH=11,ATTRIB=(UNPROT,NUM) DFHMDF POS=(7,18),LENGTH=1,ATTRIB=ASKIP MSG DFHMDF POS=(24,1),LENGTH=70,ATTRIB=ASKIP DFHMSD TYPE=FINAL END Um MAPSET pode conter vários MAPAS, mas muitas vezes contém apenas 1 mapa. Não podemos definir um MAPA sem definir também o MAPSET. Para fazer a definição é necessário utilizarmos as macros BMS que o CICS fornece. As macros são: - DFHMSD: define o mapset; - DFHMDI: define o mapa; - DFHMDF: define campos no mapa. O exemplo acima mostra a definição de um MAPSET chamado TESTMS1. Nesse MAPSET temos apenas um MAPA definido – TESTMP. Em seguida, temos as definições dos campos do MAPA. O atributo IC, indica que neste campo é que deve ser posicionado o cursor.Apenas um campo em cada mapa deve conter este atributo. ___________________________________________________________________________________________ CICS – COBOL Command Level 24 Podemos utilizar parâmetros para definir a picture de edição do campo e também para alinhamento e valorização de caracteres não preenchidos. PICOUT=‘99’ �demonstrará para o usuário o campo com esta edição. JUSTIFY=(LEFT,BLANK) ou JUSTIFY=(RIGHT,ZERO)� alinhará o campo à esquerda ou à direita e valorizará os caracteres não preenchidos com brancos ou zeros. Se quisermos inserir neste Mapset mais um Mapa devemos colocar outro DFHMDI antes do DFHMSD TYPE=FINAL. 4.6 Compilação de um mapa Após definir o Mapset/Mapa, temos que fazer sua geração. Isso é feito através da compilação do Mapset, através de uma PROCEDURE. Essa compilação é feita em duas fases: - 1ª fase: compilação e linkedição resultando em um módulo executável assembler, que é catalogado em uma biblioteca de programas. Esse módulo é chamado de Mapa Físico, composto pelas informações definidas nas macros. Assim como os programas, os mapas físicos dever ser definidos na PPT do CICS; - 2ª fase: compilação das macros, resultando no Mapa Simbólico, que na verdade é o Copybook Cobol referenciando os campos que serão utilizados no programa. 4.7 Mapas e Programas Durante a compilação do programa, o COPY ‘nome-do-mapset’ colocado na WORKING-STORAGE expande o Mapa Simbólico, para podermos referenciar os campos do mapa. Durante a execução do programa, quando é emitido um comando para receber ou enviar um mapa, o Mapa físico é executado. ___________________________________________________________________________________________ CICS – COBOL Command Level 25 A seguir veremos o resultado da expansão do COPY TESTMS1 codificado na WORKING do programa. Percebam que todos os campos que foram definidos com label no BMS aparecem no copybook gerado. Mapa Simbólico COPY TESTMS1. 01 TESTMPI. 02 FILLER PIC X(12). 02 NOMEL PIC S9(04) COMP. 02 NOMEF PIC X(01). 02 FILLER REDEFINES NOMEF. 03 NOMEA PIC X(01). 02 NOMEI PIC X(30). 02 ENDERL PIC S9(04) COMP. 02 ENDERF PIC X(01). 02 FILLER REDEFINES ENDERF. 03 ENDERA PIC X(01). 02 ENDERI PIC X(40). 02 CPFL PIC S9(04) COMP. 02 CPFF PIC X(01). 02 FILLER REDEFINES CPFF. 03 CPFA PIC X(01). 02 CPFI PIC X(11). 02 MSGL PIC S9(04) COMP. 02 MSGF PIC X(01). 02 FILLER REDEFINES MSGF. 03 MSGA PIC X(01). 02 MSGI PIC X(70). 01 TESTMPO REDEFINES TESTMPI. 02 FILLER PIC X(12). 02 FILLER PIC X(03). 02 NOMEO PIC X(30). 02 FILLER PIC X(03). 02 ENDERO PIC X(40). 02 FILLER PIC X(03). 02 CPFO PIC X(11). 02 FILLER PIC X(03). 02 MSGO PIC X(70). ___________________________________________________________________________________________ CICS – COBOL Command Level 26 I: INPUT L: TAMANHO DO CAMPO RECEBIDO F: FLAG X’00’ OU X’80’ A: ATRIBUTO O: OUTPUT Como o mapa foi definido como INPUT/OUTPUT, a área TESTMPI é redefinida com o nome TESTMPO (I=input/O=output). Cada campo aparece 5 vezes, com sufixos diferentes. Tomando como exemplo o campo nome, temos: - NOMEL: (L=LENGTH) esse campo será alimentado pelo CICS com o tamanho do conteúdo digitado pelo usuário em uma operação de Input; - NOMEF: (F=FLAG) em uma operação de Input, esse campo poderá ter o conteúdo X’00’ ou então X’80’ se o usuário digitar informações no campo e em seguida apagar essa informação utilizando a tecla ERASE EOF; - NOMEI: (I=INPUT) armazena o conteúdo pelo usuário no campo; - NOMEA: (A=ATRIBUTO) é o campo que podemos alterar o atributo default de um campo em uma operação de Output; - NOMEO: (O=OUTPUT) contém a informação que queremos enviar para o terminal do usuário. 1 – Limpar a tela não é movimentar spaces. 2 – Movimentar low-values é manter os campos da tela. 3 – Para ligar MDT � atributo = FSET 4.8 Enviando Mapas 4.8.1 Send Map O comando SEND MAP é utilizado para enviar um mapa ao terminal do usuário. Como podemos ter mais de um mapa em um mapset, temos que informar o nome do mapa e também do mapset. ___________________________________________________________________________________________ CICS – COBOL Command Level 27 O SEND MAP pega os dados do mapa simbólico (WORKING), agrega ao mapa físico e envia para o terminal do usuário. EXEC CICS SEND MAP(‘TESTMP’) MAPSET(‘TESTMS1’) END-EXEC. 4.8.2 Opções As opções MAPONLY e DATAONLY servem para economizar transmissão de dados durante uma operação de envio de mapas. - MAPONLY faz com que o CICS envie para o terminal do usuário apenas o mapa físico, ignorando o conteúdo do mapa simbólico. Por exemplo, o mapa enviado durante a primeira execução de uma transação (mapa limpo); - DATAONLY faz com que o CICS envie para o terminal apenas os dados do mapa simbólico, fazendo um “refresh” no terminal do usuário, já que o mapa físico foi enviado na primeira execução da transação. 1) EXEC CICS SEND MAP(‘TESTMP’) MAPSET(‘TESTMS1’) MAPONLY END-EXEC. No exemplo acima estamos enviando apenas o mapa físico, não estamos enviando dados. 2) EXEC CICS SEND MAP(‘TESTMP’) MAPSET(‘TESTMS1’) DATAONLY END-EXEC. Já neste exemplo 2 estamos enviando apenas o mapa simbólico. Para mantermos atributos, devemos mover low-values para os campos atributos e os demais (TESTMPO) e enviar DATAONLY. 3) EXEC CICS SEND MAP(‘TESTMP’) ___________________________________________________________________________________________ CICS – COBOL Command Level 28 MAPSET(‘TESTMS1’) FROM(TESTMPO) END-EXEC. Neste exemplo 3 estamos enviando os dados de output. 4) IDENTIFICATION DIVISION. PROGRAM-ID. FAT1PGM. WORKING-STORAGE SECTION. COPY TESTMS1. LINKAGE SECTION. 01 DFHCOMMAREA PIC X(10). PROCEDURE DIVISION. IF EIBCALEN EQUAL ZEROS MOVE ‘DIGITE DADOS’ TO MSGO EXEC CICS SEND MAP (‘TESTMP’) MAPSET (‘TESTMS1’) FROM (TESTMPO) ERASE ALARM FREEKB END-EXEC. O exemplo acima mostra o envio de um mapa para o terminal do usuário durante a primeira execução da transação (1ª fase da pseudo-conversação). A opção ERASE serve para limpar a tela do terminal antes de enviar o mapa. A opção FREEKB faz com que o teclado do terminal seja liberado logo após o envio do mapa. A opção ALARM faz som quando starta a tela. Nesse exemplo a opção MAPONLY não pode ser utilizada pois queremos que o conteúdo do campo MSGO seja enviado ao usuário juntamente com o mapa físico. Para posicionar o cursor no meio do programa, devemos mover (–1) para o campo L e colocar o parâmetro CURSOR no comando SEND. ___________________________________________________________________________________________ CICS – COBOL Command Level 29 Quando for especificado o parâmetro CURSOR no comando SEND, e no mapa existe um campo com atributo IC, prevalecerá o posicionamento especificado no SEND. 4.9 Recebendo Mapas – Receive Map IDENTIFICATION DIVISION. PROGRAM-ID. FAT1PGM. WORKING-STORAGE SECTION. 77 W-ERR PIC S9(08) COMP. 01 ARQ-REG. 02 REG-NOME PIC X(30). .... COPY TESTMS1. PROCEDURE DIVISION. EXEC CICS RECEIVE MAP (‘TESTMP’) MAPSET (‘TESTMS1’) INTO (TESTMPI) RESP (W-ERR) END-EXEC. IF W-ERR EQUAL DFHRESP(MAPFAIL) PERFORM TRATA-MAPFAIL. IF NOMEL NOT EQUAL ZEROS MOVE NOMEI TO REG-NOME. O comando utilizado para receber mapas é o RECEIVE MAP. Assim como no SEND MAP, devemos informar o nome do mapa e do mapset. Testar sempre a possibilidade da condição de exceçãoMAPFAIL durante um RECEIVE MAP. Ela pode ocorrer nas seguinte situações: - tela do terminal em branco (limpa) no momento do RECEIVE MAP ( tamanho 0) - tela do terminal com um mapa, porém nenhum ___________________________________________________________________________________________ CICS – COBOL Command Level 30 campo com MDT ON (tamanho 0) - mapa com campos MDT ON, porém o usuário tecla CLEAR ou PAs - conteúdo da tela do terminal composto de dados não formatados no momento do RECEIVE MAP. 4.10 Manuseio de teclas e atributos Para podermos alterar atributos e testar teclas em um programa, o CICS fornece dois copybooks que podem ser incluídos na WORKING-STORAGE: - DFHBMSCA: contém uma série de campos com todas as combinações possíveis de atributos de campos. Dessa forma, podemos alterar o atributo default movendo uma das combinações para o campo com sufixo A; - DFHAID: contém uma lista com teclas (ENTER, PFs, PAs, CLEAR,...) para podermos testar no programa. Mostraremos abaixo um exemplo de codificação. Note que o primeiro teste feito no programa é o da tecla PF3. Se essa tecla for acionada, a pseudo- conversação termina. Em seguida, está sendo testado se a transação está sendo executada pela primeira vez. Em caso positivo, um mapa limpo (MAPONLY) está sendo enviado ao terminal do usuário e a task termina encadeando uma pseudo-conversação e passando uma commarea. Se não for a primeira execução da transação, é feito um RECEIVE MAP para receber os dados digitados pelo usuário. No RECEIVE MAP, se ocorrer um MAPFAIL, uma mensagem informativa é enviada ao usuário através do SEND MAP, e a task termina encadeando pseudo-conversação. Caso o MAPFAIL não ocorra, o programa executará a função solicitada e terminará enviando o mapa com uma mensagem de execução bem sucedida. WORKING-STORAGE SECTION. 77 W-ERR PIC S9(08) COMP. 77 COM-WORK PIC X(10). COPY DFHBMSCA. ___________________________________________________________________________________________ CICS – COBOL Command Level 31 COPY DFHAID. COPY TESTMS1. LINKAGE SECTION. 01 DFHCOMMAREA. 02 COM-FLAG PIC X(10). PROCEDURE DIVISION. IF EIBAID EQUAL DFHPF3 EXEC CICS RETURN END-EXEC. IF EIBCALEN EQUAL ZEROS EXEC CICS SEND MAP (‘TESTMP’) MAPSET (‘TESTMS1’) MAPONLY ERASE FREEKB END-EXEC EXEC CICS RETURN TRANSID (EIBTRNID) COMMAREA (COM-WORK) END-EXEC. EXEC CICS RECEIVE MAP (‘TESTMP’) MAPSET (‘TESTMS1’) INTO (TESTMPI) RESP (W-ERR) END-EXEC. IF W-ERR EQUAL DFHRESP(MAPFAIL) MOVE LOW-VALUES TO TESTMPO MOVE ‘FAVOR ENTRAR DADOS’ TO MSGO EXEC CICS SEND MAP (‘TESTMP’) MAPSET (‘TESTMS1’) FROM (TESTMPO) DATAONLY FREEKB END-EXEC EXEC CICS RETURN TRANSID (EIBTRNID) COMMAREA(COMM-FLAG) END-EXEC. *PROCESSA FUNÇÃO SOLICITADA MOVE LOW-VALUES TO TESTMPO MOVE ‘FUNÇÃO COMPLETADA COM SUCESSO’ TO MSGO EXEC CICS SEND MAP (‘TESTMP’) ___________________________________________________________________________________________ CICS – COBOL Command Level 32 MAPSET (‘TESTMS1’) FROM (TESTMPO) DATAONLY FREEKB END-EXEC EXEC CICS RETURN END-EXEC. 5. UNIDADE 3 5.1 Envio e recepção de mapas Essa unidade mostrará outras características de mapas BMS, bem como outras opções no envio e recepção de mapas. É um complemento do que foi visto na unidade 2. 5.2 Mapa simbólico – WORKING X LINKAGE O mapa simbólico (Copybook) Cobol geralmente é copiado na WORKING- STORAGE do programa. Mas nada impede que seja copiado na LINKAGE SECTION. Para isso devemos saber que o endereçamento (addressability) de áreas na LINKAGE é responsabilidade do programa. 5.3 Recebendo Mapa na LINKAGE SECTION Quando utilizamos a LINKAGE SECTION para copiar o mapa simbólico (copybook cobol), devemos utilizar a opção SET ao invés de INTO no comando RECEIVE MAP. Com SET, o CICS adquire a área de memória, armazena as informações e fornece o endereço da área para o programa endereçar o copybook em LINKAGE. LINKAGE SECTION. 01 DFHCOMMAREA. COPY TESTMS1. PROCEDURE DIVISION. EXEC CICS RECEIVE MAP (‘TESTMP’) MAPSET (‘TESTMS1’) SET (ADDRESS OF TESTMPI) END-EXEC. ___________________________________________________________________________________________ CICS – COBOL Command Level 33 5.4 Send Map – Constantes e variáveis Quando utilizamos constantes para os argumentos das opções MAP e MAPSET em um comando SEND MAP, não é necessário especificar a opção FROM. Se utilizarmos variáveis para as opções MAP e MAPSET, temos que especificar a opção FROM. Se desejamos codificar apenas a opção MAP no comando SEND MAP, devemos ter o mapa e o mapset definidos com o mesmo nome. MAPA SIMBÓLICO SEND MAP(‘TESTMP’) TESTMPO MAPSET(‘TESTMS1’) MOVE ‘TESTMP’ TO W-MAPA. TESTMPO MOVE ‘TESTMS1’ TO W-MAPSET. SEND MAP(W-MAPA) MAPSET(W-MAPSET) FROM(TESTMPO) SEND MAP(‘TESTMS1’) TESTMPO 5.5 Receive Map – Constantes e variáveis Quando utilizamos constantes para os argumentos das opções MAP e MAPSET em um comando RECEIVE MAP, não é necessário especificar a opção INTO. Se utilizarmos variáveis para as opções MAP e MAPSET, temos que especificar a opção INTO. Se desejamos codificar apenas a opção MAP no comando RECEIVE MAP, devemos ter o mapa e o mapset definidos com o mesmo nome. MAPA SIMBÓLICO RECEIVE MAP(‘TESTMP’) TESTMPI ___________________________________________________________________________________________ CICS – COBOL Command Level 34 MAPSET(‘TESTMS1’) MOVE ‘TESTMP’ TO W-MAPA. TESTMPI MOVE ‘TESTMS1’ TO W-MAPSET. RECEIVE MAP(W-MAPA) MAPSET(W-MAPSET) INTO(TESTMPI) RECEIVE MAP(‘TESTMS1’) TESTMPI 5.6 Send Map – Funções de controle SEND MAP(‘TESTMP’) MAPSET(‘TESTMS1’) [ERASE | ERASEAUP] [FREEKB] [ALARM] [FRSET] [PRINT] OU SEND CONTROL ... - ERASE � limpa buffer do terminal e envia dados - ERASEAUP � limpa todos os campos desprotegidos antes de enviar dados - FREEKB � destrava o teclado do terminal - ALARM � soa o alarme ao enviar dados - FRSET � desliga o MDT de todos os campos PRINT � quando o terminal associado é uma impressora. ___________________________________________________________________________________________ CICS – COBOL Command Level 35 As opções de controle de output mostradas acima em um comando SEND MAP também podem ser emitidas através do comando SEND CONTROL. 5.7 RECEIVE – tecla e cursor Em uma operação de RECEIVE, o CICS informa ao programa qual a posição do cursor na tela e também qual tecla foi pressionada (EIBCPOSN e EIBAID). Assim, podemos trabalhar com barras de ações e também com teclas funcionais, por exemplo PF3 = FIM, PF8 = AVANÇA TELA). 5.8 Edição de campos – Built in Function Podemos em algumas ocasiões permitir ao usuário que digite dados com caracteres especiais como ‘$” ou “.” ou ainda “,”. Entretanto, se desejarmos realizar operações aritméticas utilizando esses campos, devemos retirar os caracteres não numéricos. O comando BIF DEEDIT pode ser utilizado para retirar os caracteres especiais de um campo, preparando-o para operações aritméticas. A opção LENGTH não é necessária para programas COBOL II. EXEC CICS BIF DEEDIT FIELD (AMOUNT) LENGTH (9) END-EXEC. Podemos editar campos na tela, basta em sua definição acrescentar o parâmetro PICOUT ( por exemplo, = Z.ZZ9,99) e a saída do campo já ficará editada.___________________________________________________________________________________________ CICS – COBOL Command Level 36 6. UNIDADE 4 6.1 Acessando VSAM Nessa unidade veremos como o CICS trabalha com o método de acesso VSAM (Virtual Storage Access Method), quais os tipos de arquivos VSAM suportados, e qual o procedimento para fazer acesso direto e também seqüencial (Browse). Os arquivos VSAM são definidos para o CICS através da tabela FCT (File Control Table). Nessa tabela temos toda informação referente ao arquivo, inclusive os tipos de operação que poderão ser realizadas. Um programa Cobol/CICS não tem definição física do arquivo que será acessado, e também não faz abertura ou fechamento dos arquivos. Os arquivos geralmente são abertos pelo CICS quando um acesso for solicitado. Dentro do programa, definimos na WORKING o layout do registro, e o campo chave – RIDFLD (Record Id Field). O comando para leitura direta é o READ. 6.2 VSAM – Recuperação Direta 6.2.1 VSAM ESDS ESDS – ENTRY SEQUENCED DATA SET O ESDS é o tipo de arquivo VSAM com estrutura seqüencial. Operações que podem ser realizadas: - Leitura direta através do RBA (Relative Byte Address) ou seqüencial; - Gravação sempre após o último registro existente; - Atualização de registros, sem alteração de seu tamanho; - Não podemos excluir registros; - A inclusão é seqüencial. registro ___________________________________________________________________________________________ CICS – COBOL Command Level 37 6.2.1.1 Relative Byte Address 0 100 200 REG1 REG2 REG3 O RBA é o deslocamento em bytes do registro a partir do início do arquivo, como por exemplo, olhando a figura acima, concluímos que o RBA do registro 2 é 100. 6.2.2 VSAM RRDS RRDS – RELATIVE RECORD DATA SET O RRDS é composto por uma série de “slots” (gavetas) de tamanho fixo, uma para cada registro. Operações que podem ser realizadas: - Leitura direta através do RRN (Relative Record Number) ou seqüencial; - Gravação de registro no seu respectivo “slot”; - Atualização de registros; - Exclusão de registros. 100 100 100 bytes bytes bytes REG3 REG1 REG2 REG4 ___________________________________________________________________________________________ CICS – COBOL Command Level 38 6.2.3 VSAM KSDS KSDS – KEY SEQUENCED DATA SET O KSDS é o tipo de arquivo VSAM com estrutura de índices. Operações que podem ser realizadas: - Leitura direta através da chave do registro ou seqüencial; - Gravação de registros; - Atualização de registros; - Exclusão de registros. É o tipo de arquivo mais utilizado sob CICS. 6.2.4 Campo Chave (RIDFLD) Identificação do registro – RIDFLD. Para arquivos KSDS o RIDFLD deve conter a chave do registro a ser acessado. Podemos também acessar registros por pedaço de chave (Chave parcial = KEYLENGTH). Para os arquivos ESDS o RIDFLD deve ser um campo de quatro bytes em formato binário (s9(08) comp) e deve conter o RBA do registro a ser acessado. Para os arquivos RRDS o RIDFLD deve ser um campo de quatro bytes em formato binário (s9(08) comp) e deve conter o RRN do registro a ser acessado. 6.2.5 Comando para Leitura - READ Para programas COBOL II não é necessário utilizar a opção LENGTH se os registros tiverem tamanho fixo. Se a leitura for feita utilizando chave parcial, além de KEYLENGTH devemos especificar a opção GENERIC. 28 15 22 34 41 ___________________________________________________________________________________________ CICS – COBOL Command Level 39 EXEC CICS READ FILE (‘name’) INTO (data-area) RIDFLD (data-area) [RBA | RRB] [LENGTH (data-area)] [GENERIC] [KEYLENGTH(data-value)] [GTEQ | EQUAL] END-EXEC. WORKING-STORAGE SECTION. 05 W-CHAVE PIC X(05). 05 W-REG PIC X(80). ... PROCEDURE DIVISION. ... MOVE ‘00010’ TO W-CHAVE EXEC CICS READ FILE (‘ARQ1’) INTO (W-REG) RIDFLD (W-CHAVE) END-EXEC. O exemplo mostra a leitura do registro chave 00010 de um arquivo KSDS. 6.2.6 Condições de exceção Sempre devemos utilizar a opção RESP nos comandos de READ. Abaixo algumas condições de exceção: - NOTFND: registro não encontrado em leitura direta; - ENDFILE: fim de arquivo em pesquisa seqüencial (veremos no próximo tópico); - INVREQ: solicitação inválida; ___________________________________________________________________________________________ CICS – COBOL Command Level 40 - FILENOTFOUND: o arquivo não está cadastrado na tabela FCT; - ILLOGIC: erro detectado pelo VSAM (veremos mais a frente); - IOERR: erro no I/O; - NOTOPEN: arquivo fechado; - DISABLED: o arquivo está desabilitado para acesso, provavelmente em conseqüência de outro problema. 6.2.6.1 Manuseando condições de exceção Utilizando a opção RESP, o CICS não toma nenhuma ação se uma condição de exceção ocorrer. Desse modo, nosso programa deve testar o conteúdo do campo utilizado no RESP e tomar as providências cabíveis. WORKING-STORAGE SECTION. 05 W-CHAVE PIC X(05). 05 W-ERR PIC S9(08) COMP. ... PROCEDURE DIVISION. ... MOVE ‘00022’ TO W-CHAVE EXEC CICS READ FILE (‘ARQ1’) INTO (W-REG) RIDFLD (W-CHAVE) RESP (W-ERR) END-EXEC. IF W-ERR EQUAL DFHRESP(NOTFND) .... ELSE IF W-ERR NOT EQUAL DFHRESP(NORMAL) ___________________________________________________________________________________________ CICS – COBOL Command Level 41 ... 6.3 VSAM – Recuperação Seqüencial (BROWSE) Para fazer pesquisa seqüencial (Browse) em um arquivo, é necessário posicionar o ponteiro de leitura na chave desejada através do comando STARTBR, e em seguida fazer a leitura seqüencial dos registros (READNEXT ou READPREV). Para terminar o browse emitir o comando ENDBR. 6.3.1 Comandos para recuperação seqüencial 6.3.1.1 Posicionando chave - STARTBR O comando STARTBR é utilizado para posicionar a chave no registro desejado (estabelecer posição). O Default para o STARTBR é GTEQ, isto é, se a chave desejada não existir, o posicionamento será feito no registro seguinte. Esta leitura seqüencial é muito utilizada em programas de paginação. EXEC CICS STARTBR FILE (name) RIDFLD (data-area) [RBA | RRN] [GENERIC] [KEYLENGTH(data-value) ] [GTEQ | EQUAL] END-EXEC. ___________________________________________________________________________________________ CICS – COBOL Command Level 42 6.3.1.2 Lendo seqüencialmente - READNEXT Após estabelecer posição com o STARTBR, podemos começar e ler o arquivo seqüencialmente em ordem ascendente de chave através do comando READNEXT. EXEC CICS READNEXT FILE (name) INTO (data-area) RIDFLD (data-area) [RBA | RRN] [LENGTH (data-area)] END-EXEC. 6.3.1.3 Lendo seqüencialmente - READPREV Se desejarmos ler o arquivo seqüencialmente em ordem descendente de chave, podemos utilizar o comando READPREV. EXEC CICS READPREV FILE (name) INTO (data-area) RIDFLD (data-area) [RBA | RRN] [LENGTH (data-area)] END-EXEC. 6.3.1.4 Alterando posicionamento da chaves - RESETB R Se durante uma operação de Browse desejarmos reposicionar o ponteiro de leitura para outra chave, podemos utilizar o comando RESETBR, ou então mover a nova chave para o campo RIDFLD e utilizar o READNEXT/READPREV. EXEC CICS RESETBR FILE (name) INTO (data-area) RIDFLD (data-area) [RBA | RRN] ___________________________________________________________________________________________ CICS – COBOLCommand Level 43 [GENERIC] [KEYLENGTH(data-value)] [GTEQ | EQUAL] END-EXEC. 6.3.1.5 Terminando Browse - ENDBR Ao terminar a consulta, temos que terminar o Browse com o comando ENDBR. EXEC CICS ENDBR FILE (name) END-EXEC. MOVE ‘00003’ TO W-CHAVE. EXEC CICS STARTBR FILE (‘ARQ1’) RIDFLD (W-CHAVE) RESP (W-ERR) END-EXEC. IF W-ERR EQUAL DFHRESP(NORMAL) PERFORM UNTIL W-ERR EQUAL DFHRESP(ENDFILE) EXEC CICS READNEXT FILE (‘ARQ1’) INTO (W-REG) RIDFLD (W-CHAVE) RESP (W-ERR) END-EXEC ..... END-PERFORM EXEC CICS ENDBR FILE (‘ARQ1’) END-EXEC ELSE .... Devemos controlar a condição de exceção ENDFILE que ocorrerá após a leitura do último registro com READNEXT ou após a leitura do primeiro registro com o READPREV. ___________________________________________________________________________________________ CICS – COBOL Command Level 44 7. UNIDADE 5 7.1 Atualizando VSAM Na unidade anterior verificamos como é feito o acesso para leitura em arquivos VSAM. Nesta unidade veremos o que é necessário para atualizar arquivos VSAM. Conheceremos também mecanismos CICS e VSAM para garantir a integridade de nossos dados. 7.2 Considerações sobre integridade Como o CICS é um produto multi-usuário e multi-tarefa, tem a obrigação de fornecer mecanismos de controle de integridade de dados. Temos que ter proteção para casos de interrupções não programadas, tais como erros de operação, abends de tasks, falta de energia, e até mesmos fatores físicos como por exemplo, um incêndio. Além disso, temos a necessidade de proteção de recursos, para que vários usuários não consigam atualizar o mesmo registro em determinado instante. 7.3 Controle exclusivo – VSAM x CICS Para manter a integridade de arquivos VSAM, o CICS fornece dois tipos de controle exclusivo: - Controle exclusivo do VSAM: quando uma task está atualizando um registro, o Control Interval (CI) que contém o registro atualizado fica “preso” para essa task até a atualização terminar. Essa proteção funciona de forma automática. - Controle exclusivo do CICS: é uma extensão da proteção mostrada acima. Após atualizar, o VSAM libera o CI, mas o CICS “prende” o registro até o fim da LUW. Essa proteção funciona apenas para arquivos definidos como recuperáveis. 7.4 A necessidade de proteção Imaginemos uma transação que vai atualizar o arquivo de caderneta de poupança subtraindo R$ 500. Em seguida, atualizará o arquivo de conta corrente adicionando os R$ 500. Como os dois arquivos são logicamente relacionados, temos que ter a garantia de atualização de ambos ou no caso de falha, que nenhum seja atualizado. Nesse caso, ambos devem ser definidos como arquivos recuperáveis. Se o primeiro sofrer atualização e ocorrer alguma falha na atualização do segundo, o CICS automaticamente deve desfazer a atualização para que ambos fiquem sincronizados. Esse processo de desfazer a atualização é chamado BACKOUT. ___________________________________________________________________________________________ CICS – COBOL Command Level 45 7.5 LUW e Backout Para garantir a integridade de arquivos recuperáveis, o CICS trabalha com um conceito denominado Logical Unit of Work (LUW). Uma LUW sempre tem início quando uma task ter a intenção de atualizar um arquivo recuperável ( por ex.: um Read com Update). Essa LUW permanece aberta (In-flight) até ocorrer um SYNCPOINT (final de task ou comando SYNCPOINT). Quando a LUW termina ocorre a efetivação de todas as atualizações (Commit). Se ocorrer alguma falha antes do término da LUW, o CICS fará um backout de todos os arquivos recuperáveis que foram atualizados. O comando EXEC CICS SYNCPOINT END-EXEC efetiva atualizações nos VSAMs e o comando EXEC CICS SYNCPOINT ROLLBACK END-EXEC desfaz todas as atualizações do programa 7.6 Atualização VSAM Para atualizar um arquivo, adicionamos a opção UPDATE ao comando READ. Quando fazemos o READ UPDATE, ocorre o controle exclusivo do VSAM. Esse controle permanece até: - REWRITE: atualização do registro; - DELETE: exclusão do registro; - UNLOCK: cancelamento da intenção de atualização; - FIM DA TASK. 7.7 Atualização de um registro O comando REWRITE faz a atualização de um registro. O campo chave não pode ser alterado. ___________________________________________________________________________________________ CICS – COBOL Command Level 46 EXEC CICS REWRITE FILE (name) FROM (data-area) [LENGTH (data-value)] END-EXEC. Antes do comando REWRITE é obrigatório utilizar o comando READ UPDATE: EXEC CICS READ FILE(‘ARQ1’) INTO(W-REG) RIDFLD(W-CHAVE) UPDATE END-EXEC. 7.8 Exclusão de registro(s) O comando DELETE exclui um registro do arquivo. O campo chave (RIDFLD) não é necessário se ocorrer um READ UPDATE antes do DELETE. Podemos fazer uma exclusão genérica, informando as opções KEYLENGTH e GENERIC. Nesse caso, se especificarmos NUMREC, o CICS informará quantos registros foram excluídos na operação. EXEC CICS DELETE FILE (name) [RIDFLD (data-area)] [KEYLENGTH (data-value)] [GENERIC | NUMREC (data-area)] [RBA | RRN] END-EXEC. ___________________________________________________________________________________________ CICS – COBOL Command Level 47 Apenas os arquivos KSDS e RRDS podem ter registros excluídos. 7.9 Liberação de registro Se decidirmos não fazer a atualização após o comando READ UPDATE, podemos liberar o controle exclusivo através do comando UNLOCK. EXEC CICS UNLOCK FILE (name) END-EXEC. 7.10 Condições de exceção As condições de exceção mais freqüentes são: - NOSPACE: ao fazer a atualização de um registro de tamanho variável, aumentamos seu tamanho e não há espaço para regravação; - INVREQ: solicitação inválida. Por exemplo, emitir o comando REWRITE sem ter feito o READ UPDATE; - LENGERR: o tamanho do registro a ser regravado é muito grande; - ILLOGIC: erro do VSAM que não se enquadra nas outras exceções. No caso da condição de exceção ILLOGIC, podemos utilizar o campo EIBRCODE para auxiliar na depuração do erro. Nos bytes 1 e 2 ele traz o tipo de erro: -byte 1: return code do VSAM -byte 2: error code do VSAM ___________________________________________________________________________________________ CICS – COBOL Command Level 48 7.11 Codificação - atualização Abaixo temos um exemplo de codificação de uma leitura para atualização seguida de regravação do registro atualizado. MOVE ‘00003’ TO W-CHAVE. EXEC CICS READ FILE (‘ARQ1’) INTO (W-REG) RIDFLD (W-CHAVE) UPDATE RESP (W-ERR) END-EXEC. IF W-ERR NOT EQUAL DFHRESP(NORMAL) PERFORM ROT-ERRO. *MOVE ALTERAÇÕES PARA ARQUIVO EXEC CICS REWRITE FILE (‘ARQ1’) FROM (W-REG) RESP (W-ERR) END-EXEC. IF W-ERR NOT EQUAL DFHRESP(NORMAL) PERFORM ROT-ERRO. 7.12 Desenho Conversacional O controle exclusivo do VSAM – que “prende” todo o CI para essa task – só terminará quando ocorrer o comando REWRITE. O controle exclusivo, nesse caso, vai ter a duração do tempo que o usuário levar entre receber as informações em seu terminal, pensar nos dados que serão alterados, digitar as alterações e pressionar Enter. Enquanto isso, qualquer outra task desejando atualizar um registro do mesmo CI ficará em wait. (esperando). ___________________________________________________________________________________________ CICS – COBOL Command Level