You are on page 1of 41

PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS

Padrão para Documentação de Procedures

Histórico
Data Versão Descrição Autor
29/10/2013 3.3 Correções e atualizações Rosângela Miranda,
a
M Clareth de Castro

22/05/2012 3.2 Alteração na regra de Formação do nome da F6836888 - Maria


Documentação. Clareth e F2259548 -
Daniela Von Zubem
20/05/2010 3.1 Correções e atualizações Laudemiro (Miro),
Rambinho e Andréia
Gomes, Paulo
César(PC)
Laudemiro (Miro)
Alexandre
(Rambinho)Andréia
03/09/2009 3 Revisão. Gomes
23/03/2007 2 Exclusão das referências do LIC Cláudia Galvão
31/01/2007 1 Implantação Cláudia Galvão

;
Padrão para Documentação de Procedures GPROM6 131029 Página 1 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

Índice Analítico
1. Introdução ....................................................................................................................................3
1.1 Formação do nome da Documentação ................................................................................4
2. Composição da Documentação ...................................................................................................4
2.1 Elementos e estrutura da Documentação ....... ...................................................................4
2.2 Capítulos da Documentação ................................................................................................5
2.2.1 Histórico – Capítulo 1 ... .................................................................................................5
2.2.2 Identificação – Capítulo 2................................................................................................7
2.2.3 Finalidade – Capítulo 3. ..................................................................................................7
2.2.4 Ambientes e Periodicidades – Capítulo 4. .......................................................................7
2.2.5 Horários de execução – Capítulo 5 . ................................................................................9
2.2.6 Procedures executadas antes – Capítulo 6 . ...................................................................10
2.2.7 Condições para iniciar a execução – Capítulo 7 . ..........................................................10
2.2.8 Recursos utilizados – Capítulo 8 . .................................................................................12
2.2.9 Providências complementares – Capítulo 9 . ................................................................12
2.2.10 Providências complementares – JOB – Capítulo .......................................................13
2.2.11 Parâmetros simbólicos da procedure – Obrigatórios – Capítulo 11 . ..........................16
2.2.12 Parâmetros simbólicos da procedure – Opcionais – Capítulo 12 . ..............................19
2.2.13 Parâmetros de programas (PARM) da procedure – Capítulo 13 . ...............................21
2.2.14 Parâmetro REGION do JOB para execução da procedure – Capítulo 14 . .................21
2.2.15 Parâmetro COND do JOB para execução da procedure – Capítulo 15 . .....................22
2.2.16 Códigos de retorno dos programas (Return Codes) da procedure – Capítulo 16 .......22
2.2.17 Arquivos Recebidos - Capítulo 17. .............................................................................23
2.2.18 Arquivos Enviados - Capítulo 18 . ..............................................................................23
2.2.19 Instruções para gerenciamento - Capítulo 19 . ............................................................24
2.2.20 Instruções em caso de ABEND - Capítulo 20 . ...........................................................25
2.2.21 Instruções para reprocessamento - Capítulo 21 . .........................................................25
2.2.22 Instruções para migração - Capítulo 22 . .....................................................................26
2.2.23 Instruções para contingência - Capítulo 23 . ...............................................................26
2.2.24 Relatórios - Capítulo 24 ..............................................................................................26
2.2.25 Cardlib - Capítulo 25 . .................................................................................................27
2.2.26 Linhas excluídas da versão anterior - Capítulo 26 . ....................................................28
2.2.27 Instruções Exclusivas aos Desenvolvedores do Sistema - Capítulo 27 . .....................29
3. Tabelas .......................................................................................................................................29
3.1 Tabela de Periodicidades ..................................................................................................29
3.2 Tabela de Sites de Processamento ....................................................................................30
3.3 Tabela de Silos de Aplicação .............................................................................................30
4. Exemplos de Documento de Procedure ....................................................................................30
4.1 Exemplo por site de processamento ..................................................................................30

;
Padrão para Documentação de Procedures GPROM6 131029 Página 2 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

4.2 Exemplo por silo de aplicação ...........................................................................................37

1. Introdução
O padrão descrito neste documento é aplicável a novas documentações. As pré-
existentes deverão ser adequadas gradativamente, conforme a capacidade das gerências
envolvidas.
O objetivo é documentar uma Procedure e os procedimentos complementares
vinculados a ela para sua execução em processamento batch em ambiente de grande porte
(Mainframe) sob o subsistema JES2.
As instruções devem ser claras, sem redundâncias, sem expressões óbvias,
observações e palavras dispensáveis. Não podem ser utilizadas expressões de solicitações,
favores, caráter pessoal e generalidades eventuais. A construção da documentação da
procedure não pode ser elaborada da mesma forma que uma “Ordem de Serviço”.
Não pode constar detalhe de como a rotina deve ser estruturada no produto de schedule
(atualmente no Banco do Brasil é o Control-M) ou parâmetros da linguagem proprietária (Auto-
Edição) do scheduler. Por exemplo, usar &JOBNAME e &ORDERID ao invés de %%JOBNAME
e %%ORDERID, respectivamente.
Uma Documentação pode existir sem Procedure. É utilizada para documentar apenas a
execução de providências complementares. Neste caso, o conteúdo dos capítulos 11, 12, 13,
14, 15, 16 (da documentação) é a expressão NIHIL.
É recomendado que se faça a redação sem acentuação e letra ‘Ç’, toda em caixa-alta.
O documento deverá ser elaborado em registros de 80 colunas e não deverá conter
qualquer caractere nas colunas 1, 71 e 73 a 80, exceto no capítulo 10 (da documentação) onde
os cartões de JCL deverão iniciar na coluna 01. A coluna 72 é reservada para indicação, com a
letra ‘X’ em caixa-alta, de inclusões de linhas e alterações nas linhas relativas ao conteúdo da
versão anterior.
As linhas excluídas, em relação à versão anterior, constam do capítulo 26 (da
documentação), identificando o capítulo de origem e sem a indicação com a letra ‘X’ na coluna
72.
Para composição da DOCLIB são considerados dois tipos de ambientes:
Site de Processamento – rotinas que executam especificamente em determinadas
partições do mainframe, conforme Tabela de Sites de Processamento (capitulo 3.2).. No
capítulo 04 (da documentação), indicar todos os ambientes onde é executada a rotina.
Nos detalhes dos diversos capítulos, quando houver pelo menos uma diferença, são
indicadas todas as siglas dos ambientes onde executa.
Silo de Aplicação – rotinas agrupadas em um Pacote de Serviços que executam em
qualquer site de processamento definido pela Infraestrutura. V. Tabela de Silos de
Aplicação no capitulo 3.3. No capítulo 4 (da documentação), sempre indicar os
ambientes PRODUCAO e HOMOLOGACAO. Para rotinas que não executam em um dos
dois ambientes informar a expressão ‘NIHIL’. Nos detalhes dos diversos capítulos,
quando houver pelo menos uma diferença, são indicados para PRODUCAO e
HOMOLOGACAO.

;
Padrão para Documentação de Procedures GPROM6 131029 Página 3 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

1.1 Formação do nome da Documentação


O nome da documentação tem estrutura análoga à utilizada para composição do nome
da procedure. A Dssspnnn reporta-se à Pssspnnn onde:
• D é fixo indicando Documentação;
• sss é a sigla do aplicativo;
• p é a periodicidade da rotina conforme Tabela de Periodicidades;
• nnn é um número sequencial de 001 a 999.
Obs.1 O valor para nnn pode ser Hnn, onde H é fixo e nn é um número sequencial
de 01 a 99, para rotinas executadas em ambiente de:
 Produção: para extração de dados de produção, redução, mascaramento e
transmissão, via FTS, para o ambiente de Homologação;
 Homologação: para recepção desses arquivos.
Obs.2 Após a utilização do range nnn (numérico) como definido acima, poderá
ser estendido para o range aaa (alfanumérico). O range aaa deverá ser utilizado
da forma a01 a z99, desde que respeitado o valor Haa para as Procedures
relacionadas com a Homologação.

2. Composição da Documentação
2.1 Elementos e estrutura da Documentação
A documentação da PROCEDURE é estruturada em capítulos.
A estrutura deve obedecer à formatação definida neste documento, observando a
identação de cada elemento, para viabilizar coleta dinâmica de dados.
Os capítulos da documentação são:
01. HISTÓRICO;
02. IDENTIFICAÇÃO;
03. FINALIDADE;
04. AMBIENTES E PERIODICIDADES;
05. HORÁRIOS DE EXECUÇÃO;
06. PROCEDURES EXECUTADAS ANTES;
07. CONDIÇÕES PARA INICIAR A EXECUÇÃO;
08. RECURSOS UTILIZADOS;
09. PROVIDÊNCIAS COMPLEMENTARES;
10. PROVIDÊNCIAS COMPLEMENTARES-JOB;
11. PARÂMETROS SIMBÓLICOS DA PROCEDURE-OBRIGATÓRIOS;
12. PARÂMETROS SIMBÓLICOS DA PROCEDURE-OPCIONAIS;
13. PARÂMETROS DE PROGRAMAS (PARM) DA PROCEDURE;

;
Padrão para Documentação de Procedures GPROM6 131029 Página 4 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

14. PARÂMETRO REGION DO JOB PARA EXECUÇÃO DA PROCEDURE;


15. PARÂMETRO COND DO JOB PARA EXECUÇÃO DA PROCEDURE;
16. CÓDIGOS DE RETORNO DOS PROGRAMAS (RETURN CODES) DA
PROCEDURE;
17. ARQUIVOS RECEBIDOS;
18. ARQUIVOS ENVIADOS;
19. INSTRUÇÕES PARA GERENCIAMENTO;
20. INSTRUÇÕES EM CASO DE ABEND;
21. INSTRUÇÕES PARA REPROCESSAMENTO;
22. INSTRUÇÕES PARA MIGRAÇÃO;
23. INSTRUÇÕES PARA CONTINGÊNCIA;
24. RELATÓRIOS;
25. CARDLIB;
26. LINHAS EXCLUÍDAS DA VERSÃO ANTERIOR;
27. INSTRUÇÕES EXCLUSIVAS AOS DESENVOLVEDORES DOS SISTEMAS.
A numeração dos capítulos em dois dígitos inicia na coluna 2 seguida de ponto.
Os títulos dos capítulos iniciam nas colunas 6 e não possuem o sinal de ponto final ou
outros sinais de pontuação. Entre o título do capítulo e os seus detalhes não há linha em
branco.
Os capítulos são separados por duas linhas em branco.
Os detalhes dos capítulos iniciam na coluna 6, sem linha em branco entre eles. Para os
capítulos com indicação de ambiente ou itens alfabéticos (09,10,24), utilizar a formatação descrita
em cada capítulo.

Quando não existir conteúdo para o capítulo este é preenchido com a expressão
"NIHIL".
As instruções nos diversos capítulos devem existir somente para os ambientes onde a
rotina é executada. Caso não haja instrução para um desses ambientes de processamento
citado, utilizar a expressão 'NIHIL'.
Nos capítulos onde as instruções são iguais para todos os ambientes de execução não indicar a
mesma informação separadamente para cada um dos ambientes. Só deverá ser informado
separadamente se existir pelo menos uma instrução diferente para um destes ambientes.

Quando há indicação do site de processamento, a sigla em dois dígitos será seguida do


sinal de dois pontos e um espaço em branco antes do texto.
Quando há indicação dos silos de aplicação, as palavras PRODUCAO e
HOMOLOGACAO serão seguidas do sinal de dois pontos com espaço(s) em branco antes do
texto. Alinhar as informações relativas aos dois ambientes.

;
Padrão para Documentação de Procedures GPROM6 131029 Página 5 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

2.2 Capítulos
2.2.1 Histórico – Capítulo 1.
A descrição sumária de todas as versões inicia na coluna 6 e termina, no máximo, na
coluna 70. Manter a ordem decrescente de versões.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
01. HISTORICO
VRS004-04/04/04-CCCCCCCC-(FULANO)-MOTIVO MOTIVO MOTIVO MOTIVO X
MOTIVO MOTIVO MOTIVO. X
CCCCCCCC-(CICRANO)-MOTIVO MOTIVO MOTIVO MOTIVO X
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO, X
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO. X
VRS003-03/03/03-CCCCCCCC-(BELTRANO)-MOTIVO MOTIVO MOTIVO MOTIVO
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO,
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO.
VRS002-12/02/02-CCCCCCCC-(BELTRANO)-MOTIVO MOTIVO MOTIVO MOTIVO
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO,
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO.
02/02/02-CCCCCCCC-(CICRANO)-MOTIVO MOTIVO MOTIVO MOTIVO
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO.
VRS001-01/01/01-CCCCCCCC-(FULANO)-IMPLANTACAO.

Formatação:
VRSnnn-dd/mm/aa-cccccccc-(nome)-mmmmmmmmmmmmmmmmmm
mmmmmmmmmmmmmmmmmmmmmm
mmmmmmmmmmmmmmmmmmmmmm
onde:
• VRS - Fixo, inicia na coluna 6;
• nnn - Número da versão, inicia na coluna 9 ;
• dd/mm/aa - Data da alteração, inicia na coluna 13;
• cccccccc - Chave do responsável pela alteração, inicia na coluna 22;
• nome - Nome do responsável pela alteração, entre parênteses, iniciando na coluna
31 da primeira linha de motivos. Separar o sinal de fecha parênteses do início do
texto com um hífen e sem espaços em branco.
• mmm...m - Motivo da alteração. Inicia logo após o nome, na primeira linha, e na
coluna 31, a partir da segunda linha, e pode ser utilizada com texto até a coluna 70,
em quantas linhas forem necessárias. Não iniciar o texto com espaços em branco
visando alinhá-los com o início do texto da primeira linha. Iniciar na coluna 31,
alinhado com o parêntese aberto para citação do nome.
Os quatro campos (versão, data, chave do responsável e texto do motivo da
alteração), quando informados, são separados por hífen e sem espaços em branco.
Para uma única versão alterada por mais de um responsável, em datas diferentes ou
não, poderão ser omitidos o primeiro campo VRSnnn- e o primeiro e segundo campos
VRSnnn-dd/mm/aa-, respectivamente.

;
Padrão para Documentação de Procedures GPROM6 131029 Página 6 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

2.2.2 Identificação – Capítulo 2.


Contém sigla e nome do aplicativo a que se refere a documentação, conforme cadastro
no DPR, e o nome da procedure objeto da documentação, quando houver.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
02. IDENTIFICACAO
APLICATIVO - SSS - NOME DO APLICATIVO CONFORME DPR
PROCEDURE - PSSSD999

Formatação:
• Na linha 1, iniciar na coluna 6 pela palavra-chave APLICATIVO seguida de espaço,
hífen, espaço. A sigla do aplicativo inicia na coluna 19 seguida de espaço, hífen,
espaço e o nome do aplicativo inicia na coluna 25 e termina na coluna 70. Abreviar o
nome do aplicativo quando necessário. NÃO INCLUIR PONTUAÇÃO ALGUMA.
• Na linha 2, iniciar na coluna 6 pela palavra chave PROCEDURE seguida de espaço,
hífen, espaço e o nome da procedure (início na coluna 18) ou a expressão “NIHIL”.

2.2.3 Finalidade – Capítulo 3.


Descrição sucinta dos objetivos da rotina.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
03. FINALIDADE
GERACAO DO ARQUIVO XXXF101 CONTENDO A DEPENDENCIA SUBORDINADORA
POR DEPENDENCIA, ANO-MES E TOTALIZACAO.

Formatação:
• Texto livre entre as colunas 06 e 70 em quantas linhas forem necessárias.

2.2.4 Ambientes e Periodicidades – Capítulo 4.


No capítulo 04, ao contrário dos demais capítulos, deverão ser descritos todos os
ambientes onde é executada a rotina, mesmo que a instrução seja idêntica para todos os
ambientes.
Informar em quais ambientes a rotina será executada e a respectiva periodicidade
conforme Tabela de Periodicidades (capitulo 3.1).

;
Padrão para Documentação de Procedures GPROM6 131029 Página 7 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

Para rotinas de suporte para manutenção de infraestrutura do Complexo poderá ser


utilizada a expressão TODOS. A especificação dos ambientes de processamento ficará a cargo
das equipes do Suporte a esse segmento.
Contém informações sobre quando a rotina deve ser executada, tais como:
• execução em dias úteis ou não úteis;
• execução em dias anteriores ou posteriores a dias úteis ou não;
• qual o dia da semana, decêndio, quinzena, mês;
Para a periodicidade EVENTUAL não há informações adicionais: elas serão descritas
apenas no capítulo 07 – Condições para iniciar a Execução.
Nas rotinas que executam vinculadas ao Sites de Processamento, informar conforme
Tabela de Sites de Processamento (capitulo 3.2). Não é necessário informar o ambiente
em que não ocorrer processamento.
Exemplo por site processamento:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
04. AMBIENTES E PERIODICIDADES
BR: DIARIA - SOMENTE NOS DIAS UTEIS
B2: MENSAL – TODO DIA 15 OU DIA UTIL POSTERIOR
B3: DIARIA - TODOS OS DIAS (UTEIS OU NAO)
EXCETO NO PRIMEIRO DIA DO ANO
RJ: DIARIA - EXCETO FERIADOS E DOMINGOS
HM: EVENTUAL

As rotinas vinculadas a um Silo de Aplicação têm a indicação do SILO na primeira linha,


conforme Tabela de Silos de Aplicação (capitulo 3.3).
Indicar sempre PRODUCAO e HOMOLOGACAO na segunda e terceira linha. Caso não
execute em um dos dois ambientes deverá constar a expressão “NIHIL” e nos demais capítulos
não deverão ser especificados, pois não haverá diferença por ambiente.
O ambiente de processamento de cada silo de aplicação é determinado pela
Infraestrutura.
Exemplo por silo aplicação:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
04. AMBIENTES E PERIODICIDADES
SILO FINANCAS
PRODUCAO: DIARIA – TODOS OS DIAS UTEIS
HOMOLOGACAO: DIARIA – TODOS OS DIAS UTEIS

Formatação:
• A indicação do ambiente de processamento (sigla de dois dígitos) ou de aplicação
(PRODUCAO e HOMOLOGACAO) inicia na coluna 6 seguido do sinal de dois
pontos.
• a informação de periodicidade (conforme Tabela 3.1) inicia na coluna 19. Se houver
necessidade de complementar a informação, preencher “branco hífen branco” e a
instrução, em quantas linhas forem necessárias , em texto livre até a coluna 70.

;
Padrão para Documentação de Procedures GPROM6 131029 Página 8 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

2.2.5 Horários de execução – Capítulo 5.


Informar os horários de execução da procedure ou dos procedimentos complementares.
Para execuções no horário compreendido entre 7 e 17h, no ambiente de Produção e em
dias úteis, é obrigatória a informação de nível de restrição (baixa, média e alta), conforme IN
sobre regras para o ambiente de produção 646-1.10.10. Para restrições média e alta deve ser
informado o motivo de execução neste horário.
Existindo diferenças, relacionar todos os ambientes constantes do capítulo 04.
Pode utilizar a expressão ‘NIHIL’.

Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
05. HORARIOS DE EXECUCAO
19:00 HORAS

Exemplo por site processamento:


<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
05. HORARIOS DE EXECUCAO
BR: 11:00 HORAS
RESTRICAO: ALTA
MOTIVO: JOB FAZ TRANSMISSAO DE ARQUIVO PARA O BANCO
CENTRAL AS 12:00.
B2: 13:00 HORAS
RESTRICAO: BAIXA
MOTIVO: NIHIL
B3: 02:00 HORAS
RJ: 18:00 HORAS PREVIA 1
19:00 HORAS PREVIA 2
HM: ENTRE 17 E 19:00 HORAS A CADA 1 HORA

Exemplo por silo aplicação:


<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
05. HORARIOS DE EXECUCAO
PRODUCAO: 12:00 HORAS
RESTRICAO:ALTA
MOTIVO: JOB FAZ TRANSMISSAO DE ARQUIVO PARA O BANCO
CENTRAL AS 12:00.
HOMOLOGACAO: 17:00 HORAS

Formatação:
• Texto livre entre as colunas 6 e 70 em quantas linhas forem necessárias (se não
houver diferença entre os ambientes)
• Se houver diferença entre os ambientes, a indicação do ambiente de
processamento ou de aplicação inicia na coluna 6 seguido do sinal de dois pontos e
o texto inicia na coluna 10 (site de processamento) ou 19 (silo de aplicação).

;
Padrão para Documentação de Procedures GPROM6 131029 Página 9 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

• ·Quando houver a informação de Nível de Restrição, as indicações RESTRICAO


(ALTA, MEDIA, BAIXA) e MOTIVO (texto livre) deverão ser declaradas nas linhas
seguintes à da informação do horário.

2.2.6 Procedures executadas antes – Capítulo 6.


Relacionar somente as procedures, ou seus JOB complementares, cujos términos
normais dos processamentos são pré-requisitos.
Indicar quando as datas de movimento forem diferentes.
Existindo diferenças relacionar todos os ambientes constantes do capítulo 04.
Pode utilizar a expressão ‘NIHIL’.
Não utilizar expressões como “APÓS O FIM NORMAL DE...”.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
06. PROCEDURES EXECUTADAS ANTES
PSSSD001 E PSSSD002

Exemplo por site processamento:


<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
06. PROCEDURES EXECUTADAS ANTES
BR: PSSSD001 E PSSSD002
B2: SSSD001A,SSSD001B e PSSSD002
B3: PSSSD001 – Movimento do dia anterior.
RJ: NIHIL
HM: PSSSD001, PSSSD002 E PSSSD003

Exemplo por silo aplicação:


<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
06. PROCEDURES EXECUTADAS ANTES
PRODUCAO: PSSSD001 E PSSSD002
HOMOLOGACAO: PSSSD111 E PSSSD222

Formatação:
• Texto livre entre as colunas 6 e 70 em quantas linhas forem necessárias.
• Quando houver, a indicação do ambiente de processamento ou de aplicação inicia
na coluna 6 seguido do sinal de dois pontos e o texto inicia na coluna 10 (para sites
de processamento) ou 19 (para silos de aplicação).

2.2.7 Condições para iniciar a execução – Capítulo 7.


Pré-requisitos para execução em condições diversas.
Informar as condições específicas para iniciar a execução, tais como:

;
Padrão para Documentação de Procedures GPROM6 131029 Página 10 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

Recepção de arquivos, solicitação do responsável pelo sistema, procedimentos


específicos de outras rotinas, return-codes de steps de outras procedures, migrações,
implantações, especificações do suporte a produtos, start por aplicação ONLINE etc.

Existindo diferenças relacionar todos os ambientes constantes do capítulo 04.


Pode utilizar a expressão ‘NIHIL’.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
07. CONDICOES PARA INICIAR A EXECUCAO
A PEDIDO DO RESPONSAVEL PELA APLICACAO

Exemplo por site processamento:


<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
07. CONDICOES PARA INICIAR A EXECUCAO
BR: MONITORES GRI INATIVOS
B3: RECEPCAO DOS ARQUIVOS BBN.XXX888 E BBN.XXX777
RJ: RECEPCAO DO ARQUIVO DE CONVENIO XXX999
HM: NIHIL

Exemplo por silo aplicação:


<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
07. CONDICOES PARA INICIAR A EXECUCAO
PRODUCAO: RETURN CODE DO STEP SSSP000 DA PROCEDURE PSSSP001
IGUAL A 0 OU 4
HOMOLOGACAO: NIHIL

Para rotinas ativadas por transação ONLINE, para cada ambiente de execução, deverão
ser documentados os parâmetros utilizados.
Exemplo de ativação por transação online:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
07. CONDICOES PARA INICIAR A EXECUCAO
BR: STARTADA POR TRANSACAO DO APLICATIVO SSS
OPCAO 9.99.A.
B2: STARTADA POR TRANSACAO DO APLICATIVO SSS
OPCAO 9.99.A.
S CONTFRC,SYS=SSS,JOB=SSSENNN,DTMOV=DDMMAA,
S1=’AAAAAAAABBBBBBBBBBBBB’,
S2=’CCCCCCDDDDDDDDEEEEEE’,
STR03=’DD.MM.AAAAFFF’
- ONDE:
AAAAAAAA = DATA = DE 01 A 08 DE S1
BBBBBBBBBBBBB = EMPRESA = DE 09 A 21 DE S1
CCCCCC = USER = DE 01 A 06 DE S1
DDDDDDDD = PUNCH = DE 07 A 14 DE S2
EEEEEE = SISTEMAS = DE 15 A 20 DE S2
DD.MM.AAAA = MVTO = DE 01 A 10 DE STR03
FFF = CODIGO = DE 11 A 13 DE STR03

Formatação:

;
Padrão para Documentação de Procedures GPROM6 131029 Página 11 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

• Texto livre entre as colunas 6 e 70 em quantas linhas forem necessárias.


• Quando houver, a indicação do ambiente de processamento ou de aplicação inicia
na coluna 6 seguido do sinal de dois pontos.
2.2.8 Recursos utilizados – Capítulo 8.
Relacionar os recursos utilizados na execução da procedure e das providências
complementares.
Pode utilizar a expressão NIHIL.
Exemplo:

<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
08. RECURSOS UTILIZADOS
DB2, FTS, ADABAS, CICS, FTP, GRI, RVS, CDT

Formatação:
• Texto livre entre as colunas 6 e 70 em quantas linhas forem necessárias.

2.2.9 Providências complementares – Capítulo 9.


Indicar instruções complementares para montagem da estrutura do JOB de execução da
procedure, tais como: execução por grupo, por partição, por prévia, por dependência, por GRI,
por arquivo, execução exclusiva ou simultânea com outras rotinas, não execução em caso de
abend.
Indicar a execução de outras procedures e os valores a serem utilizados para seus
parâmetros simbólicos antes e após o término da execução desta procedure ou de seus jobs
complementares (capítulo 10), tais como: OPR, EVT, GDR, STR, SOL, GRC, INI, DEB.
As instruções para transmissão de arquivos para outras empresas devem constar
apenas no capítulo 18 – Arquivos Enviados.
Pode utilizar a expressão ‘NIHIL’.
As diferenças referentes aos ambientes de execução constantes do capítulo 04 são
citadas no texto de cada item.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
09. PROVIDENCIAS COMPLEMENTARES
A) TEXTO1 TEXTO1 TEXTO1 TEXTO1.
TEXTO1 TEXTO1 TEXTO1 TEXTO1.

B) TEXTO2 TEXTO2 TEXTO2 TEXTO2.


TEXTO2 TEXTO2 TEXTO2 TEXTO2.
TEXTO2 TEXTO2 TEXTO2 TEXTO2.

C) TEXTO3 TEXTO3 TEXTO3 TEXTO3.

Formatação:

;
Padrão para Documentação de Procedures GPROM6 131029 Página 12 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

• As providências complementares deverão ser especificadas em itens sequenciados


alfabeticamente (a partir da letra A), utilizando a letra na coluna 6 e “)” após a letra.
• Os itens são separados por uma linha em branco.
• Texto livre entre as colunas 9 e 70 em quantas linhas forem necessárias.

2.2.10 Providências complementares – JOB – Capítulo 10.


Indicar os JOB a serem executados antes ou depois do job de execução da procedure.
Indicar instruções diversas a serem adotadas para cada job complementar.
Só poderá conter execução de procedures utilitárias catalogadas (ADA, APR, CIC, DB2,
DWH, GDR, INI, RDX, STH, UTI), os programas SYS000, SYS055 e SYS108.
Não poderão conter arquivos instream nem cartão JOB.
Não deverão ser informados no ONDE: os valores para os parâmetros simbólicos: HLQ,
CARDLIB, CPDLIB, CPU, CICSLIB, TABELA e DTMOV. Esses valores ficarão a cargo da
infraestrutura.
Quando a DOCLIB for construída por Silo de Aplicação, não deverão ser informados os
valores para os parâmetros simbólicos: DB2, D, C, A e S. Esses valores ficarão a cargo da
infraestrutura. Pode utilizar a expressão ‘NIHIL’.
Exemplo por site de processamento:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
10. PROVIDENCIAS COMPLEMENTARES - JOB
A) SSSD999A:
EM BR E RJ, ANTES DA PSSSD999, EXECUTAR O JOB ABAIXO, QUE
TEM POR FINALIDADE FAZER UNLOAD DA TABELA XXX_YYY_ZZZ.
ESSE JOB NAO PODERAH SER EXECUTADO SIMULTANEAMENTE COM
O JOB SSSD999B.
//*-------------------------------------------------------------*
//SYS000A EXEC PGM=SYS000,
// PARM='&HLQ..SSS.SSSFXXX1.D&DTMOV.SS000101'
//*-------------------------------------------------------------*
//PDB2E999 EXEC PDB2E999,
// MEMBRO01=&MEMBRO01,
// A=&A,
// C=&C,
// CONS=,
// CREATOR=DB2SIS,
// CSTT=,
// DRCT=NO,
// HLQ=&HLQ,
// JOBNAME=&JOBNAME,
// OBJ=S1SSS001,
// OPCAO='NEW/RESTART',
// ORD=&ORDERID,
// S=&S,
// SHLV=,
// SHRL=,
// SIS=SSS,
//*------------------------------------------------------------*
ONDE:
A - BR: A=G
RJ: A=2

C - BR: C=3
RJ: C=1

;
Padrão para Documentação de Procedures GPROM6 131029 Página 13 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

MEMBRO01 – BR: MEMBRO01=MEM1


RJ: MEMBRO01=MEM2

B) SSSD999B:
EM B2, RJ E HM, APOS O FIM NORMAL DA PSSSD999, EXECUTAR O
JOB ABAIXO, QUE TEM POR FINALIDADE FAZER LOAD
NA TABELA XXX_YYY_ZZZ.
//*-------------------------------------------------------------*
//PDB2E888 EXEC PDB2E888,
// MEMBRO01=&MEMBRO01,
// A=&A,
// CARDLIB=&CARDLIB,
// CONS=,
// CREATOR=DB2SIS,
// CSTT=,
// DIS=9,
// DRCT=NO,
// DSNREC=&HLQ..SIS.SISF999R.D&DTMOV..SS000101,
// HLQ=&HLQ,
// JOBNAME=&JOBNAME,
// LIB=&CICSLIB,
// NEW=99999,
// OBJ=S1SSS999,
// OPCAO='NEW/RESTART',
// ORD=&ORDERID,
// S=&S,
// SHLV=,
// SHRL=,
// SIS=SSS,
// SYSPUNCH=&HLQ..SIS.SISF999P.D&DTMOV..SS000101,
// TIPO=2
//*-------------------------------------------------------------*
//SYS0000A EXEC PGM=SYS000,
// PARM='&HLQ..SIS.SISF999P.D&DTMOV..SS000101'
//*-------------------------------------------------------------*
//SYS0000B EXEC PGM=SYS000,
// PARM='&HLQ..SIS.SISF999R.D&DTMOV..SS000101'
//*-------------------------------------------------------------*
ONDE:
A - B2: A=G
RJ: A=2
HM: A=G

S - B2: S=1
RJ: S=2
HM: S=3

MEMBRO01 – BR: MEMBRO01=MEM1


RJ: MEMBRO01=MEM2

Exemplo por silo de aplicação:


<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
10. PROVIDENCIAS COMPLEMENTARES - JOB
A) SSSD999A:
EM PRODUCAO E HOMOLOGACAO, ANTES DA PSSSD999, EXECUTAR
O JOB ABAIXO, QUE TEM POR FINALIDADE FAZER UNLOAD DA
TABELA XXX_YYY_ZZZ. ESSE JOB NAO PODERAH SER EXECUTADO
SIMULTANEAMENTE COM O JOB SSSD999B.
//*-------------------------------------------------------------*
//SYS000A EXEC PGM=SYS000,
// PARM='&HLQ..SSS.SSSFXXX1.D&DTMOV.SS000101'
//*-------------------------------------------------------------*
//PDB2E888 EXEC PDB2E888,

;
Padrão para Documentação de Procedures GPROM6 131029 Página 14 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

// MEMBRO01=&MEMBRO01,
// A=&A,
// C=&C,
// CONS=,
// CREATOR=DB2SIS,
// CSTT=,
// DRCT=NO,
// HLQ=&HLQ,
// JOBNAME=&JOBNAME,
// OBJ=S1SSS001,
// OPCAO='NEW/RESTART',
// ORD=&ORDERID,
// S=&S,
// SHLV=,
// SHRL=,
// SIS=SSS
//*------------------------------------------------------------*
ONDE:
A - PRODUCAO: DATA-SHARING DO DB2
HOMOLOGACAO: DATA-SHARING DO DB2

C - PRODUCAO: DATA-SHARING DO DB2


HOMOLOGACAO: DATA-SHARING DO DB2

MEMBRO01 – PRODUCAO: MEMBRO01=MEM1


HOMOLOGACAO: MEMBRO01=MEM2

B) SSSD999B:
EM PRODUCAO E HOMOLOGACAO, APOS O FIM NORMAL DA PSSSD999,
EXECUTAR O JOB ABAIXO, QUE TEM POR FINALIDADE FAZER LOAD
NA TABELA XXX_YYY_ZZZ.
//*-------------------------------------------------------------*
//PDB2E999 EXEC PDB2E999,
// MEMBRO01=&MEMBRO01,
// A=&A,
// CARDLIB=&CARDLIB,
// CONS=,
// CREATOR=DB2SIS,
// CSTT=,
// DIS=9,
// DRCT=NO,
// DSNREC=&HLQ..SIS.SISF999R.D&DTMOV..SS000101,
// HLQ=&HLQ,
// JOBNAME=&JOBNAME,
// LIB=&CICSLIB,
// NEW=99999,
// OBJ=S1SSS999,
// OPCAO='NEW/RESTART',
// ORD=&ORDERID,
// S=&S,
// SHLV=,
// SHRL=,
// SIS=SSS,
// SYSPUNCH=&HLQ..SIS.SISF999P.D&DTMOV..SS000101,
// TIPO=2
//*-------------------------------------------------------------*
//SYS0000A EXEC PGM=SYS000,
// PARM='&HLQ..SIS.SISF999P.D&DTMOV..SS000101'
//*-------------------------------------------------------------*
//SYS0000B EXEC PGM=SYS000,
// PARM='&HLQ..SIS.SISF999R.D&DTMOV..SS000101'
//*-------------------------------------------------------------*
ONDE:
A - PRODUCAO: DATA-SHARING DO DB2
HOMOLOGACAO: DATA-SHARING DO DB2

S - PRODUCAO: DATA-SHARING DO DB2


HOMOLOGACAO: DATA-SHARING DO DB2

;
Padrão para Documentação de Procedures GPROM6 131029 Página 15 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

MEMBRO01 – PRODUCAO: MEMBRO01=MEM1


HOMOLOGACAO: MEMBRO01=MEM2

Formatação:
• Os ambientes indicados para execução dos jobs complementares constam do
capítulo 4.
• O capítulo é subdividido em itens sequenciados alfabeticamente, utilizando a letra na
coluna 6 e ‘)’ após a letra. O título do item inicia na coluna 9 e é seguido do sinal de
dois pontos. As instruções do item iniciam na segunda linha, em quantas linhas
forem necessárias, sempre a partir da coluna 9.
• Os itens são separados por uma linha em branco, bem como as variáveis
informadas no “ONDE:”; não há linha em branco entre as informações dos
ambientes para cada variável.
• Os cartões de JCL iniciam na coluna 1 e terminam até a coluna 70.
• Os valores variáveis utilizados em cada simbólico, por ambiente ou execução, são
descritos após o último cartão de JCL de cada JOB.
• Entre o último cartão de JCL e a descrição dos simbólicos existe uma linha com a
palavra ONDE iniciando na coluna 6, seguida do sinal de dois pontos.
• O nome de cada variável inicia na coluna 6.
• A indicação do ambiente de processamento ou de aplicação inicia na coluna 17,
seguido do sinal de dois pontos.

2.2.11 Parâmetros simbólicos da procedure – Obrigatórios – Capítulo 11.

Parâmetro simbólico obrigatório é aquele que não consta do cartão PROC da procedure
e cujo valor deve ser atribuído no cartão EXEC para a procedure no JOB de execução.
Descrever cada um dos parâmetros simbólicos obrigatórios da procedure, informando o
seu nome, seu significado, os valores possíveis para uso e as instruções necessárias à sua
utilização.
Especificar os valores a serem utilizados, para cada um dos ambientes definidos no
capítulo 4, somente quando forem utilizados valores diferentes.
Não deverão ser informados os valores para os parâmetros simbólicos: HLQ, HLQS,
HLQN, HLQO, HLQADA, CARDLIB, CPDLIB, CICSLIB e DBRMLIB: esses valores ficarão a
cargo da infraestrutura.

;
Padrão para Documentação de Procedures GPROM6 131029 Página 16 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

Não deverão ser informados os valores para os parâmetros simbólicos: DB2, DB,
quando a DOCLIB for construída por Silo de Aplicação: esses valores ficarão a cargo da
infraestrutura.
Pode utilizar a expressão ‘NIHIL’, sendo seu uso obrigatório caso não exista procedure.
São classificados como simbólicos obrigatórios:
• high-level-qualifier dos DSN dos arquivos:
o HLQ (BRP, B2P, B3P, RJP, DSP, HMP, HMH)
o HLQO(BRO,B2O,B3O,RJO,DSO,HMO)
o HLQS (BRS, B2S, B3S, RJS, DSS, HMS)
o HLQN (NATURAL)
o HLQADA (BRADAPxx, B2ADAPxx, B3ADAPxx, RJADAPxx, DSADAPxx,
HMADAPxx)
o BBM (BBM)
• data do movimento no formato AAMMDD (seguem o calendário bancário):
o DTMOV;
o DTFUT (próximo dia útil);
o DTANT (dia útil anterior);
• Data-sharing do DB2 em quatro dígitos:
o DB2
• base de dados dos módulos em Natural:
o DB
• biblioteca de cardlib:
o CARDLIB
• biblioteca CPDLIB de programas:
o CPDLIB
• biblioteca CICSLIB de programas:
o CICSLIB
• biblioteca DBRM de programas:
o DBRMLIB
• sigla de destino (NET067) de arquivos:
o DESTCOE, para arquivos COE210*.
o DESTNTS, para arquivos NTS100*.
o DESTXX, para arquivos que serão transmitidos para silos de aplicação.
Onde XX representa a sigla do silo de aplicação.
CO – Silo Correntista

;
Padrão para Documentação de Procedures GPROM6 131029 Página 17 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

CR – Silo Crédito
FI – Silo Finanças
SE – Silo Seguridade
SU – Silo Suporte Empresarial

Exemplo por site de processamento:


<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
11. PARAMETROS SIMBOLICOS DA PROCEDURE – OBRIGATORIOS
BBM - HLQ DOS DSN DOS ARQUIVOS BBM.

CARDLIB - PARTICIONADO QUE CONTEM OS CARTOES DE CONTROLE


UTILIZADOS PARA A EXECUCAO DOS PROGRAMAS.

CICSLIB - BIBLIOTECA DE MODULOS DO CICS.

DB - BASE DE DADOS DOS MODULOS NATURAL.


BR: DB=31
B3: DB=34
RJ: DB=35
HM: DB=86

DB2 - DATA-SHARING DO DB2 EM 04 DIGITOS.


BR: DB2=D3G1
B3: DB2=D3G4
RJ: DB2=D3G5
HM: DB2=D8G6

DEST - CODIGO DE DESTINO DO ARQUIVO SSS610.


BR: DEST=BR
B3: DEST=B3
RJ: DEST=RJ
HM: DEST=HM

DESTCOE - SIGLA DE DESTINO PARA NET067 PARA O ARQUIVO COE210.

DESTFI - SIGLA DE DESTINO PARA NET067 PARA OS ARQUIVOS XPT111


E XPT222.

DESTNST - SIGLA DE DESTINO PARA NET067 PARA O ARQUIVO NTS100.

DTMOV - DATA DO MOVIMENTO NO FORMATO 'AAMMDD'.

HLQ - HIGH-LEVEL-QUALIFIER DOS DSN DOS ARQUIVOS DE DADOS.

OUTRO - FORCA A GRAVACAO DO NUMERO DA REMESSA NO HEADER DO ARQUIVO XXX999


BR: OUTRO=SIM
HM: OUTRO=NAO

Exemplo por silo aplicação:


<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
11. PARAMETROS SIMBOLICOS DA PROCEDURE - OBRIGATORIOS
BBM - HLQ DOS DSN DOS ARQUIVOS BBM.

CARDLIB - PARTICIONADO QUE CONTEM OS CARTOES DE CONTROLE


UTILIZADOS PARA A EXECUCAO DOS PROGRAMAS.

CICSLIB - BIBLIOTECA DE MODULOS DO CICS.

DB - BASE DE DADOS DOS MODULOS NATURAL.

;
Padrão para Documentação de Procedures GPROM6 131029 Página 18 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

DB2 - DATA-SHARING DO DB2 EM 04 DIGITOS.

DEST - CODIGO DE DESTINO DO ARQUIVO SSS610.


PRODUCAO: DEST=BR
HOMOLOGACAO: DEST=HM

DESTCOE - SIGLA DE DESTINO PARA NET067 PARA O ARQUIVO COE210.

DESTFI - SIGLA DE DESTINO PARA NET067 PARA OS ARQUIVOS XPT111


E XPT222.

DESTNST - SIGLA DE DESTINO PARA NET067 PARA O ARQUIVO NTS100.

DTMOV - DATA DO MOVIMENTO NO FORMATO 'AAMMDD'.

HLQ - HIGH-LEVEL-QUALIFIER DOS DSN DOS ARQUIVOS DE DADOS.

OUTRO - FORCA A GRAVACAO DO NUMERO DA REMESSA NO HEADER DO ARQUIVO XXX999


PRODUCAO: OUTRO=SIM
HOMOLOGACAO: OUTRO=NAO

Formatação:
• Os parâmetros simbólicos informados iniciam na coluna 6 e suas descrições na
coluna 17. Os campos são separados por um hífen na coluna 15, somente na
primeira linha de definição de cada parâmetro.
• A partir da segunda linha, o texto é livre entre as colunas 17 e 70. Pode utilizar
várias linhas.
• Nas linhas seguintes à descrição especificar, a partir da coluna 17, os valores a
serem utilizados para todos os ambientes constantes do capítulo 4.
• Os parâmetros simbólicos informados devem ser relacionados em ordem alfabética
e separados por uma linha em branco.

2.2.12 Parâmetros simbólicos da procedure – Opcionais – Capítulo 12.

Parâmetro simbólico opcional é aquele que consta do cartão PROC com um valor
informado para qualquer execução.
O valor poderá opcionalmente ser alterado em execuções específicas informando-o no
cartão EXEC para a procedure no JOB de execução.
Descrever cada um dos parâmetros simbólicos opcionais da procedure, informando o
seu nome, seu significado, os valores possíveis para uso e as instruções necessárias à sua
utilização.
Pode utilizar a expressão ‘NIHIL’ sendo seu uso obrigatório caso não exista procedure.
São classificados como simbólicos opcionais:
- para indicação de espaço para alocação de arquivos em disco:
QR...P, QR...S, QC...P, QC...S, QT...P, QT...S,
onde: R=registros,

;
Padrão para Documentação de Procedures GPROM6 131029 Página 19 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

C=Cilindros,
T=Trilhas
não indicar todos os simbólicos utilizados na procedure, indicar a existência do tipo de
simbólico substituindo o identificador do arquivo por três pontos. Não informar o valor
que assume no cartão PROC.
- para indicação de BUFNO dos arquivos de entrada/saída:
BF...E (arquivo de entrada), BF...S (arquivo de saída).
não indicar todos os simbólicos utilizados na procedure, indicar a existência do tipo de
simbólico substituindo o identificador do arquivo por três pontos. Não informar o valor
que assume no cartão PROC.
- para indicação do arquivo VSAM de controle de transmissão do FTS:
FTSRJE
- para indicação de parâmetros do ADABAS:
MODO, TIPO
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
12. PARAMETROS SIMBOLICOS DA PROCEDURE - OPCIONAIS
BF...E - PARAMETRO BUFNO DOS ARQUIVOS DE ENTRADA.

BF...S - PARAMETRO BUFNO DOS ARQUIVOS DE SAIDA.

FTSRJE - ARQUIVO DE CONTROLE DE TRANSMISSAO FTS.


ASSUME: FTSRJE=BBN.FTSRJE.CNTLMST

PARM001 - PARAMETRO UTILIZADO NO PROGRAMA SSSPC123.


INFORMAR PARM001=SIM QUANDO SOLICITADO PELO XXXXX.
INFORMAR PARM001=NAO QUANDO SOLICITADO PELA AGENCIA.
ASSUME: PARM001=X999S1

PLAN - PLANO DA BASE DE DADOS NO DB2.


ASSUME: PLAN=PSSS9999

QR...P - QTD DE REGISTROS PARA ALOCACAO PRIMARIA EM DISCO.

QR...S - QTD DE REGISTROS PARA ALOCACAO SECUNDARIA EM DISCO.

Formatação:
• Os parâmetros simbólicos informados iniciam na coluna 6 e suas descrições na
coluna 17. Os campos são separados por um hífen na coluna 15, somente na
primeira linha.
• A partir da segunda linha, o texto é livre entre as colunas 17 e 70. Pode utilizar
várias linhas.
• Nas linhas seguintes à descrição, iniciar na coluna 17 as instruções para eventual
utilização de outros valores.

;
Padrão para Documentação de Procedures GPROM6 131029 Página 20 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

• Informar o valor constante do cartão PROC a partir da coluna 17, no formato:


ASSUME: SSSS=VVVVV, onde: ASSUME é fixo, seguido de dois pontos e branco,
SSSS é o nome do simbólico e VVVVV é o valor atribuído no cartão PROC.
• Os parâmetros simbólicos informados devem ser relacionados em ordem alfabética
e separados por uma linha em branco.

2.2.13 Parâmetros de programas (PARM) da procedure – Capítulo 13.


Descrever cada um dos PARM utilizados pelos programas da procedure (parâmetro
PARM do EXEC) ou através da CARDLIB.
Pode utilizar a expressão ‘NIHIL’, sendo seu uso obrigatório caso não exista procedure.
Não informar o PARM dos programas:
- SYS061, SYS062, NET067, SYS000, SYS108.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
13. PARAMETROS DE PROGRAMAS (PARM) DA PROCEDURE
SSSP001 - PARM=X999S1. NO PROCESSAMENTO DIARIO.
PARM=SIM. MEDIANTE SOLICITACAO DO XXXXX, GERAR
RELATORIO SSS999 DE EMISSAO MENSAL EM DIA QUE NAO
FOR O ULTIMO DIA UTIL DO MES.
SSSP002A - PARM=X88881. NO PROCESSAMENTO MENSAL.
PARM=SIM. MEDIANTE SOLICITACAO DO XXXXX,
GERAR RELATORIO SSS888 DE EMISSAO MENSAL EM DIA
QUE NAO FOR O ULTIMO DIA UTIL DO MES.

Formatação:
• Informar o nome do PROGRAMA a partir da coluna 6 e as demais informações a
partir da coluna 17. Estes dois campos são separados por um hífen na coluna 15, na
primeira linha.
• Texto livre entre as colunas 17 e 70 em quantas linhas forem necessárias.

2.2.14 Parâmetro REGION do JOB para execução da procedure – Capítulo 14.


Informar o valor para o parâmetro REGION a ser utilizado no cartão JOB do job que
executa a procedure.
Informação obrigatória - utilizar a expressão ‘NIHIL’ apenas no caso de não existir
procedure.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
14. PARAMETRO REGION DO JOB PARA EXECUCAO DA PROCEDURE
REGION=4M

Formatação:
• Iniciar na coluna 6 com o parâmetro REGION seguido do sinal de igual.

;
Padrão para Documentação de Procedures GPROM6 131029 Página 21 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

REGION=nM

2.2.15 Parâmetro COND do JOB para execução da procedure – Capítulo 15.

Informar o valor para o parâmetro COND a ser utilizado no cartão JOB do job que
executa a procedure.
Informação obrigatória - utilizar a expressão ‘NIHIL’ apenas no caso de não existir
procedure.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
15. PARAMETRO COND DO JOB PARA EXECUCAO DA PROCEDURE
COND=((8,EQ),(12,EQ),(16,EQ),(888,EQ))

Formatação:
• Iniciar na coluna 6 com o parâmetro COND seguido do sinal de igual.

2.2.16 Códigos de retorno dos programas (Return Codes) da procedure – Capítulo


16.
Descrever cada um dos RETURN CODE emitidos pelos programas da procedure que
determinem situações específicas.
Não descrever return-code com valor igual a ‘zero’ em caso de términos considerados
normais e que não indiquem situações diferenciadas.
Informar o STEPNAME, valor do RETURN CODE e a descrição/ação.
Pode utilizar a expressão ‘NIHIL’, sendo seu uso obrigatório caso não exista procedure.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
16. CODIGOS DE RETORNO DOS PROGRAMAS (RETURN CODES) DA PROCEDURE
STEPNAME - RETURN-CODES - DESCRICAO/ACAO
SSSP111A – 3,4,5,6,7 - NAO HAH REMESSA PARA TRANSMISSAO
SSSP111A – 10 - IDEM
SSSP111A - >15 - ERRO NA GERACAO DO ARQUIVO,
NAO DEVERA SER TRANSMITIDO
SSSP999 - <> 11 - CONSIDERAR COMO ERRO,
EXECUTAR ROTINA DE RECUPERACAO PARA
GERACAO DE NOVO CADASTRO.
SSSP999 - 5 - CONSIDERAR COMO NORMAL
SSSP999 - 6 - CONSIDERAR COMO ERRO
SSSP888 - 2 - NAO SERAO EXECUTADOS OS STEPS X E Y.

Formatação:
• A primeira linha dos detalhes indica o nome das três colunas separadas por hífen da
seguinte forma:
o STEPNAME iniciando na coluna 6;

;
Padrão para Documentação de Procedures GPROM6 131029 Página 22 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

o RETURN-CODES iniciando na coluna 17;


o DESCRIÇÃO/AÇÃO iniciando na coluna 32;
o As demais linhas seguem a mesma tabulação da primeira.

2.2.17 Arquivos Recebidos - Capítulo 17.


Relacionar os arquivos a serem recebidos e as instruções necessárias para seu
recebimento, tais como as respectivas origens (de empresas externas, dependências do Banco
ou de outras procedures com NET067), meio de transmissão (FTS, RVS, CDT, EDI, XFB),
instruções/comandos para o produto e descrição do arquivo.
Não repetir estas instruções no capítulo 09 – Providências Complementares.
Pode utilizar a expressão ‘NIHIL’.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
17. ARQUIVOS RECEBIDOS
SSSF001 – DESCRICAO DO ARQUIVO
DO RJ, EMPRESA DE SEGUROS, EDI
SSS002 – DESCRICAO DO ARQUIVO
DO B3, PXXXE999, FTS
SSSF003 – DESCRICAO DO ARQUIVO
DO SILO XXXX, PYYYWH77, FTS

Formatação:
• Informar o nome principal do arquivo a partir da coluna 6 e as demais informações a
partir da coluna 17. Estes dois campos são separados por um hífen na coluna 15 na
primeira linha.

2.2.18 Arquivos Enviados - Capítulo 18.


Relacionar os arquivos a serem transmitidos, sua descrição sucinta e as instruções
necessárias para sua transmissão, tais como os respectivos destinos (para empresas externas,
para dependências do Banco ou para outras procedures com SYS061/SYS062), meio de
transmissão (FTS, CDT, RVS, EDI, XFB), instruções/comandos para o produto.
Não repetir estas instruções no capítulo 09 – Providências Complementares.
Pode utilizar a expressão ‘NIHIL’.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
18. ARQUIVOS ENVIADOS
COE210 - CORREIO SISBB CONTENDO XXX.
PARA A BASE DO APLICATIVO COE
SSSF111 - DESCRICAO DO ARQUIVO
DE BR PARA PSSSD001 EM BR
DE RJ PARA PSSSD999 EM B3
SSSF222 - DESCRICAO DO ARQUIVO
TRANSMITIDOS PARA A EMPRESA EEEEE VIA TTTT
SSSF333 - DESCRICAO DO ARQUIVO
DE B3 PARA PSSSD001 DO SILO XXXXX

;
Padrão para Documentação de Procedures GPROM6 131029 Página 23 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

DE HM PARA PSSSD999 DO SILO XXXXX


SSSF444S - DESCRICAO DO ARQUIVO
DE BR PARA A DIVISAO DDDDD POR EDI
PROC=PPPPPPPP
PNODE=PNPNPNPNPN
SNODE=SNSNSNSNSN
DSN ORIGEM=DODODODODODO
DSN DESTINO=DDDDDDDDDDDD

Formatação:
• Informar o nome principal do arquivo a partir da coluna 6 e as demais informações a
partir da coluna 17. Estes dois campos são separados por um hífen na coluna 15 na
primeira linha.

2.2.19 Instruções para gerenciamento - Capítulo 19.


Descrever cada evento por ambiente, os horários críticos, o nível de criticidade (ALTO,
MEDIO e BAIXO) ou NIHIL quando houver ausência de criticidade, o motivo da criticidade e
quais os procedimentos a serem adotados em caso de atraso.
Informar em ATRASO se o horário crítico informado é limite para o início ou fim da
rotina.
Exemplo por site de processamento:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
19. INSTRUCOES PARA GERENCIAMENTO
AMBIENTE: BR - HORARIO: 02:00 - NIVEL: ALTO
ATRASO: INICIO
MOTIVO DA CRITICIDADE: TRANSFRENCIA FECHAMENTO COMPE NO BACEN.
TEXTO LIVRE DAS COLUNAS 29 A 70.
TEXTO LIVRE DAS COLUNAS 29 A 70.
TEXTO LIVRE DAS COLUNAS 29 A 70.
PROVIDENCIAS: COMUNICAR O CSO COMPE PARA EXECUTAR O FECHAMENTO
PARCIAL.
TEXTO LIVRE DAS COLUNAS 20 A 70.
TEXTO LIVRE DAS COLUNAS 20 A 70.

AMBIENTE: BR - HORARIO: 03:00 - NIVEL: BAIXO


ATRASO: FIM
MOTIVO DA CRITICIDADE: TRANSFRENCIA FECHAMENTO COMPE NO BACEN.
PROVIDENCIAS: COMUNICAR O CSO COMPE PARA EXECUTAR O FECHAMENTO
PARCIAL.

Exemplo por silo de aplicação:


<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
19. INSTRUCOES PARA GERENCIAMENTO
AMBIENTE: PRODUCAO - HORARIO: 02:00 - NIVEL: ALTO
ATRASO: FIM
MOTIVO DA CRITICIDADE: TRANSFRENCIA FECHAMENTO COMPE NO BACEN.
PROVIDENCIAS: COMUNICAR O CSO COMPE PARA EXECUTAR O FECHAMENTO
PARCIAL.

AMBIENTE: HOMOLOGACAO - HORARIO: 03:00 - NIVEL: BAIXO


ATRASO: INICIO
MOTIVO DA CRITICIDADE: TRANSFRENCIA FECHAMENTO COMPE NO BACEN.
PROVIDENCIAS: COMUNICAR O CSO COMPE PARA EXECUTAR O FECHAMENTO
PARCIAL.

;
Padrão para Documentação de Procedures GPROM6 131029 Página 24 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

Formatação:
Na primeira linha do detalhe indicar o AMBIENTE de processamento (sigla de dois
dígitos) ou de aplicação (PRODUCAO e HOMOLOGACAO). Informar também, na primeira
linha, HORÁRIO e NÍVEL seguido do sinal de dois pontos.
• Descrever os campos em linhas e colunas conforme os exemplos.
• ATRASO: inicio ou fim
• MOTIVO DA CRITICIDADE: Texto livre entre as colunas 29 e 70 em quantas linhas
forem necessárias.
• PROVIDÊNCIAS: Texto livre entre as colunas 20 e 70 em quantas linhas forem
necessárias.
• Descrever tantos eventos quantos forem necessários.

2.2.20 Instruções em caso de ABEND - Capítulo 20.


Descrever procedimentos específicos a serem adotados para recuperação ou
continuidade do processamento em caso de ABEND.
Descrever os pontos de restart condicional e os itens a serem avaliados antes de efetuar
o restart.
Pode utilizar a expressão ‘NIHIL’.
Não deve constar instrução do tipo: “Comunicar analista responsável pelo sistema” ou
“reiniciar no ponto de restart imediatamente anterior”.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
20. INSTRUCOES EM CASO DE ABEND
EXECUTAR A ROTINA PSSSE001 PARA RECUPERACAO DO ARQUIVO LIDER,
ANTES DE REINICIAR A PROCEDURE.
EXCLUIR DO PROCESSAMENTO O ARQUIVO BBN.SSS999.*, LIDO NO STEP
STEP01, QUE CONTEM REGISTROS TRUNCADOS.
RESTART CONDICIONAL NO STEP SSSSSS, VERIFICAR MENSAGEM DO PGM.
EM CASO DE FIM ANORMAL NO STEP SSSSSSS, EXECUTAR A PROCEDURE
PSSSE999, REINICIANDO EM SEGUIDA.

Formatação:
• Texto livre entre as colunas 6 e 70 em quantas linhas forem necessárias.

2.2.21 Instruções para reprocessamento - Capítulo 21.


Descrever os procedimentos a serem adotados em caso de necessidade de
reprocessamento da rotina. Atenção: não se trata de restart, mas de executar novamente um
job já executado.
Pode utilizar a expressão ‘NIHIL’.
Exemplo:

;
Padrão para Documentação de Procedures GPROM6 131029 Página 25 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
21. INSTRUCOES PARA REPROCESSAMENTO
DELETAR OS ARQUIVOS BBN.SSS111 TRANSMITIDOS E REINICIAR A ROTINA
A PARTIR DO STEP SSSSSSSS.

Formatação:
• Texto livre entre as colunas 6 e 70 em quantas linhas forem necessárias.

2.2.22 Instruções para migração - Capítulo 22.


Descrever os procedimentos adotados para os casos de autonomia contábil,
encerramento de prefixo, migração massificada de contas entre agências/grupo-setex, de
dependências entre os grupos do DEB e entre monitores GRI.
Pode utilizar a expressão ‘NIHIL’, sendo seu uso obrigatório caso não exista procedure.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
22. INSTRUCOES PARA MIGRACAO
EM CASO DE MIGRACAO MASSIFICADA DE CONTAS ENTRE AGENCIAS,GRI/DEB
INFORMAR EM D+1 PARA O DD CARTAO O ARQUIVO CONTENDO OS PREFIXOS

Formatação:
• Texto livre entre as colunas 6 e 70 em quantas linhas forem necessárias.

2.2.23 Instruções para contingência - Capítulo 23.


Descrever os procedimentos adotados para os casos de contingência.
Pode utilizar a expressão ‘NIHIL’, sendo seu uso obrigatório caso não exista procedure.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
23. INSTRUCOES PARA CONTINGENCIA
EXECUTAR A ROTINA INFORMANDO O MONITOR DB2 ATIVO NA PARTICAO PPP.

Formatação:
• Texto livre entre as colunas 6 e 70 em quantas linhas forem necessárias.

2.2.24 Relatórios - Capítulo 24.

Relacionar e descrever cada um dos relatórios gerados pelos programas da procedure


informando:
a. Nome do relatório;
b. Título;
c. Descrição do conteúdo;

;
Padrão para Documentação de Procedures GPROM6 131029 Página 26 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

d. Código de padronização do formulário;


e. Número de cópias;
f. Salto;
g. Frequência de emissão;
h. Nome do programa gerador;
i. DATASET NAME do arquivo sem substituição de simbólicos;
j. Indicação da permissão de refazimento;
k. Forma de disponibilização do refazimento;
l. Indicação da necessidade de descarbonar, separar, cortar e encadernar;
m. Destinatários;
n. Forma de disponibilização (spool do JES, GDR, INI);
o. Conteúdo do CANAL1 no formato 1PPPP99999NNNNN, onde:
- PPPP - prefixo da dependência;
- 99999 - número do relatório;
- NNNNN - número de referência da microfilmagem.
Pode utilizar a expressão ‘NIHIL’ para o capítulo todo ou para os campos de descrição.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
24. RELATORIOS
A) RELATORIO: SSS777
TITULO: TRANSACOES REJEITADAS POR CLIENTE
CONTEUDO: QUANTIDADE DE REGISTROS GRAVADOS, REJEITADOS E
PERCENTUAL DE REJEICAO POR CLIENTE.
FORMULARIO: 0.30.300-0 NR. COPIAS: 1 SALTO: 6601
FREQUENCIA: DIARIA PROGRAMA:SSSP888
DESCARBONAR: NAO - SEPARAR: NAO - CORTAR: NAO
ARQUIVO: &HLQ..SSS.SSSF777A.D&DTMOV..SS000104
EH PERMITIDO REFAZIMENTO: SIM
FORMA DE REFAZIMENTO: FMT
DESTINATARIOS: AGENCIAS
FORMA DE DISPONIBILIZACAO: UTF, IRA E GDR.
CANAL1: 1AAAASSSSSNNNNN

B) RELATORIO: SSS888
TITULO: TRANSACOES ACEITAS POR CLIENTE
CONTEUDO: QUANTIDADE DE REGISTROS GRAVADOS, REJEITADOS E
PERCENTUAL DE REJEICAO POR CLIENTE.
FORMULARIO: 0.30.300-0 NR. COPIAS: 1 SALTO: 6601
FREQUENCIA: DIARIA PROGRAMA:SSSP888
DESCARBONAR: NAO - SEPARAR: NAO - CORTAR: NAO
ARQUIVO: &HLQ..SSS.SSSF888A.D&DTMOV..SS000104
EH PERMITIDO REFAZIMENTO: SIM
FORMA DE REFAZIMENTO: FMT
DESTINATARIOS: AGENCIAS
FORMA DE DISPONIBILIZACAO: GDR E IRA
CANAL1: 1AAAASSSSSNNNNN

Formatação:

;
Padrão para Documentação de Procedures GPROM6 131029 Página 27 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

• O capítulo pode ser subdividido em Itens sequenciados alfabeticamente. Utiliza-se a


letra na coluna 6 e ‘)’ após a letra.
• Os itens são separados por uma linha em branco.
• O título do item inicia na coluna 9, seguido do sinal de dois pontos. Iniciam na coluna
9 os detalhes do item conforme estrutura do exemplo acima.

2.2.25 Cardlib - Capítulo 25.

Relacionar as CARDLIB utilizadas na procedure e nos JOB complementares e uma


descrição sucinta.
Não transcrever o conteúdo da CARDLIB.
O nome de cada CARDLIB é formado pelo nome da documentação sem a letra ‘D’ inicial
e com uma letra ou número ao final.
Para cartões genéricos, de comandos de DB2 e SORT, usados em várias procedures de
uma mesma aplicação são válidos os nomes xxxDB201 a xxxDB205 e xxxSRT01 a xxxSRT05
(onde xxx é a sigla da aplicação).
Pode utilizar a expressão ‘NIHIL’, sendo seu uso obrigatório caso não exista procedure..

Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
25. CARDLIB
SSSP999A - DESCRICAO EM TEXTO LIVRE DA COLUNA 17 ATE A COLUNA 70.
SSSP999B - DESCRICAO EM TEXTO LIVRE DA COLUNA 17 ATE A COLUNA 70.
SSSDB201 - DESCRICAO EM TEXTO LIVRE DA COLUNA 17 ATE A COLUNA 70.

Formatação:
• Informar o nome da CARDLIB a partir da coluna 6 e a descrição a partir da coluna 17
até a 70. Estes dois campos são separados por um hífen na coluna 15.

2.2.26 Linhas excluídas da versão anterior - Capítulo 26.


Contém linhas excluídas, somente da versão anterior da documentação da procedure,
identificadas com o capítulo da qual faziam parte.
Não são sinalizadas com a letra ‘X’ na coluna 72.
Pode utilizar a expressão ‘NIHIL’.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
26. LINHAS EXCLUIDAS DA VERSAO ANTERIOR
10. PROVIDENCIAS COMPLEMENTARES - JOB
D) SSSD999D:
//*-------------------------------------------------------------*
//SYS000A EXEC PGM=SYS000

;
Padrão para Documentação de Procedures GPROM6 131029 Página 28 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

// PARM='&CDP..SSS.SSSF180.D&DTMOV..SS310801'
//*-------------------------------------------------------------*
//PDB2E880 EXEC PDB2E880,
// A=G,
// AMB=BR,
// OBJ=UNLD999,
// ORD=&ORDERID,
// PART=,
// SIS=EVT
//UNLOAD.SYSRE1 DD DSN=&CDP..SSS.SSSF180.D&DTMOV..SS310801,
// SPACE=(CYL,(150,50),RLSE),DISP=(,CATLG)
//*-------------------------------------------------------------*
11. PARAMETROS SIMBOLICOS DA PROCEDURE - OBRIGATORIOS
DTANT - DATA DO MOVIMENTO ANTERIOR NO FORMATO AAMMDD.

Formatação:
• Nome do capítulo da qual as linhas excluídas faziam parte.
• Texto original da linha excluída.

2.2.27 Instruções Exclusivas aos Desenvolvedores do Sistema - Capítulo 27.


Este capítulo tem a finalidade de reservar um espaço ao desenvolvedor para registro de
instruções específicas do sistema.
Pode utilizar a expressão ‘NIHIL’.
Exemplo:
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
27. INSTRUCOES EXCLUSIVAS AOS DESENVOLVEDORES DO SISTEMA
ESTA PROCEDURE E REFERENTE A INTERVENCAO NO SISTEMA XXX PARA
CONTEMPLAR A NOVA CLASSIFICACAO DE CLIENTE PARA O BANCO.

Formatação:
• Texto livre entre as colunas 6 e 70 em quantas linhas forem necessárias.

3. Tabelas
3.1 Tabela de Periodicidades

Tipo Descrição
D Diária
Cíclica - Diária com
I execução em intervalos
pré-definidos.
W Semanal
E Eventual
C Decendial

;
Padrão para Documentação de Procedures GPROM6 131029 Página 29 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

Q Quinzenal
M Mensal
B Bimestral
T Trimestral
U Quadrimestral
S Semestral
A Anual
3.2 Tabela de Sites de Processamento

Sigla Descrição
BR Produção - Sysplex-1
B2 Produção - Sysplex-2
RJ Produção - Rio
DS Desenvolvimento
HM Homologação - Sysplex-1

3.3 Tabela de Silos de Aplicação


Sigla
Silo
CO
Correntista
CR
Crédito
FI
Finanças
SE
Seguridade
SU
Suporte Empresarial

4. Exemplos de Documento de Procedure


4.1 Exemplo por site de processamento
01. HISTORICO
VRS004-04/04/04-CCCCCCCC-(FULANO)-MOTIVO MOTIVO MOTIVO MOTIVO X
MOTIVO MOTIVO MOTIVO. X
CCCCCCCC-(CICRANO)-MOTIVO MOTIVO MOTIVO MOTIVO X
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO, X
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO. X
VRS003-03/03/03-CCCCCCCC-(BELTRANO)-MOTIVO MOTIVO MOTIVO MOTIVO
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO,
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO.
VRS002-12/02/02-CCCCCCCC-(BELTRANO)-MOTIVO MOTIVO MOTIVO MOTIVO

;
Padrão para Documentação de Procedures GPROM6 131029 Página 30 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO,


MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO.
02/02/02-CCCCCCCC-(CICRANO)-MOTIVO MOTIVO MOTIVO MOTIVO
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO.
VRS001-01/01/01-CCCCCCCC-(FULANO)-IMPLANTACAO.

02. IDENTIFICACAO
APLICATIVO - SSS - NOME DO APLICATIVO CONFORME DPR
PROCEDURE - PSSSD999

03. FINALIDADE
GERACAO DO ARQUIVO XXXF101 CONTENDO A DEPENDENCIA SUBORDINADORA
POR DEPENDENCIA, ANO-MES E TOTALIZACAO.

04. AMBIENTES E PERIODICIDADES


BR: DIARIA - SOMENTE NOS DIAS UTEIS
B3: DIARIA - TODOS OS DIAS (UTEIS OU NAO)
EXCETO NO PRIMEIRO DIA DO ANO
RJ: DIARIA - EXCETO FERIADOS E DOMINGOS
HM: EVENTUAL

05. HORARIOS DE EXECUCAO


BR: 11:00 HORAS
RESTRICAO: ALTA
MOTIVO: JOB FAZ TRANSMISSAO DE ARQUIVO PARA O BANCO
CENTRAL AS 12:00.
B2: 13:00 HORAS
RESTRICAO: BAIXA
MOTIVO: NIHIL
B3: 02:00 HORAS
RJ: 18:00 HORAS PREVIA 1
19:00 HORAS PREVIA 2
HM: ENTRE 17:00 E 19:00 HORAS A CADA 1 HORA

06. PROCEDURES EXECUTADAS ANTES


BR: PSSSD001 E PSSSD002
B2: SSSD001A,SSSD001B e PSSSD002
B3: PSSSD001 – MOVIMENTO ANTERIOR
RJ: NIHIL
HM: PSSSD001, PSSSD002 E PSSSD003

07. CONDICOES PARA INICIAR A EXECUCAO


BR: MONITORES GRI INATIVOS
B3: RECEPCAO DOS ARQUIVOS BBN.XXX888 E BBN.XXX777
RJ: RECEPCAO DO ARQUIVO DE CONVENIO XXX999
HM: A PEDIDO DO RESPONSAVEL PELO SISTEMA

08. RECURSOS UTILIZADOS


DB2, FTS, ADABAS, CICS, FTP, GRI, RVS, CDT

09. PROVIDENCIAS COMPLEMENTARES


A) TEXTO1 TEXTO1 TEXTO1 TEXTO1.
TEXTO1 TEXTO1 TEXTO1 TEXTO1.

B) TEXTO2 TEXTO2 TEXTO2 TEXTO2.


TEXTO2 TEXTO2 TEXTO2 TEXTO2.
TEXTO2 TEXTO2 TEXTO2 TEXTO2.

C) TEXTO3 TEXTO3 TEXTO3 TEXTO3.

10. PROVIDENCIAS COMPLEMENTARES - JOB

;
Padrão para Documentação de Procedures GPROM6 131029 Página 31 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

A) SSSD999A:
EM BR E RJ, ANTES DA PSSSD999, EXECUTAR O JOB ABAIXO, QUE
TEM POR FINALIDADE FAZER UNLOAD DA TABELA XXX_YYY_ZZZ.
ESSE JOB NAO PODERAH SER EXECUTADO SIMULTANEAMENTE COM
O JOB SSSD999B.
//*-------------------------------------------------------------*
//SYS000A EXEC PGM=SYS000,
// PARM='&HLQ..SSS.SSSFXXX1.D&DTMOV.SS000101'
//*-------------------------------------------------------------*
//PDB2E999 EXEC PDB2E999,
// MEMBRO01=&MEMBRO01,
// A=&A,
// C=&C,
// CONS=,
// CREATOR=DB2SIS,
// CSTT=,
// DRCT=NO,
// HLQ=&HLQ,
// JOBNAME=&JOBNAME,
// OBJ=S1SSS001,
// OPCAO='NEW/RESTART',
// ORD=&ORDERID,
// S=&S,
// SHLV=,
// SHRL=,
// SIS=SSS,
// TABLE='XXX_YYY_ZZZ'
//*------------------------------------------------------------*
ONDE:
A - BR: A=G
RJ: A=2

C - BR: C=3
RJ: C=1

MEMBRO01 – BR: MEMBRO01=MEM1


RJ: MEMBRO01=MEM2

B) SSSD999B:
EM B2, RJ E HM, APOS O FIM NORMAL DA PSSSD999, EXECUTAR O
JOB ABAIXO, QUE TEM POR FINALIDADE FAZER LOAD
NA TABELA XXX_YYY_ZZZ.
//*-------------------------------------------------------------*
//PDB2E888 EXEC PDB2E888,
// MEMBRO01=&MEMBRO01,
// A=&A,
// CARDLIB=&CARDLIB,
// CONS=,
// CREATOR=DB2SIS,
// CSTT=,
// DIS=9,
// DRCT=NO,
// DSNREC=&HLQ..SIS.SISF999R.D&DTMOV..SS000101,
// HLQ=&HLQ,
// JOBNAME=&JOBNAME,
// LIB=&CICSLIB,
// NEW=99999,
// OBJ=S1SSS999,
// OPCAO='NEW/RESTART',
// ORD=&ORDERID,
// S=&S,
// SHLV=,
// SHRL=,
// SIS=SSS,
// SYSPUNCH=&HLQ..SIS.SISF999P.D&DTMOV..SS000101,
// TAB='XXX_YYY_ZZZ',
// TIPO=2

;
Padrão para Documentação de Procedures GPROM6 131029 Página 32 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

//*-------------------------------------------------------------*
//SYS0000A EXEC PGM=SYS000,
// PARM='&HLQ..SIS.SISF999P.D&DTMOV..SS000101'
//*-------------------------------------------------------------*
//SYS0000B EXEC PGM=SYS000,
// PARM='&HLQ..SIS.SISF999R.D&DTMOV..SS000101'
//*-------------------------------------------------------------*
ONDE:
A - B2: A=G
RJ: A=2
HM: A=G

S - B2: S=1
RJ: S=2
HM: S=3

MEMBRO01 – BR: MEMBRO01=MEM1


RJ: MEMBRO01=MEM2

11. PARAMETROS SIMBOLICOS DA PROCEDURE – OBRIGATORIOS


BBM - HLQ DOS DSN DOS ARQUIVOS BBM.

CARDLIB - PARTICIONADO QUE CONTEM OS CARTOES DE CONTROLE


UTILIZADOS PARA A EXECUCAO DOS PROGRAMAS.

CICSLIB - BIBLIOTECA DE MODULOS DO CICS.

DB - BASE DE DADOS DOS MODULOS NATURAL.


BR: DB=31
B3: DB=34
RJ: DB=35
HM: DB=86

DB2 - DATA-SHARING DO DB2 EM 04 DIGITOS.


BR: DB2=D3G1
B3: DB2=D3G4
RJ: DB2=D3G5
HM: DB2=D8G6

DEST - CODIGO DE DESTINO DO ARQUIVO SSS610.


BR: DEST=BR
B3: DEST=B3
RJ: DEST=RJ
HM: DEST=HM

DESTCOE - SIGLA DE DESTINO PARA NET067 PARA O ARQUIVO COE210.

DESTFI - SIGLA DE DESTINO PARA NET067 PARA OS ARQUIVOS XPT111


E XPT222.

DESTNST - SIGLA DE DESTINO PARA NET067 PARA O ARQUIVO NTS100.

DTMOV - DATA DO MOVIMENTO NO FORMATO 'AAMMDD'.

HLQ - HIGH-LEVEL-QUALIFIER DOS DSN DOS ARQUIVOS DE DADOS.

OUTRO - FORCA A GRAVACAO DO NUMERO DA REMESSA NO HEADER DO ARQUIVO XXX999


BR: OUTRO=SIM
HM: OUTRO=NAO

12. PARAMETROS SIMBOLICOS DA PROCEDURE - OPCIONAIS


BF...E - PARAMETRO BUFNO DOS ARQUIVOS DE ENTRADA.

BF...S - PARAMETRO BUFNO DOS ARQUIVOS DE SAIDA.

FTSRJE - ARQUIVO DE CONTROLE DE TRANSMISSAO FTS.


ASSUME: FTSRJE=BBN.FTSRJE.CNTLMST

;
Padrão para Documentação de Procedures GPROM6 131029 Página 33 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

PARM001 - PARAMETRO UTILIZADO NO PROGRAMA SSSPC123.


INFORMAR PARM001=SIM QUANDO SOLICITADO PELO XXXXX.
INFORMAR PARM001=NAO QUANDO SOLICITADO PELA AGENCIA.
ASSUME: PARM001=X999S1

PLAN - PLANO DA BASE DE DADOS NO DB2.


ASSUME: PLAN=PSSS9999

QR...P - QTD DE REGISTROS PARA ALOCACAO PRIMARIA EM DISCO.

QR...S - QTD DE REGISTROS PARA ALOCACAO SECUNDARIA EM DISCO.

13. PARAMETROS DE PROGRAMAS (PARM) DA PROCEDURE


SSSP001 - PARM=X999S1. NO PROCESSAMENTO DIARIO.
PARM=SIM. MEDIANTE SOLICITACAO DO XXXXX, GERAR
RELATORIO SSS999 DE EMISSAO MENSAL EM DIA QUE NAO
FOR O ULTIMO DIA UTIL DO MES.
SSSP002A - PARM=X88881. NO PROCESSAMENTO MENSAL.
PARM=SIM. MEDIANTE SOLICITACAO DO XXXXX,
GERAR RELATORIO SSS888 DE EMISSAO MENSAL EM DIA
QUE NAO FOR O ULTIMO DIA UTIL DO MES.

14. PARAMETRO REGION DO JOB PARA EXECUCAO DA PROCEDURE


REGION=4M

15. PARAMETRO COND DO JOB PARA EXECUCAO DA PROCEDURE


COND=((8,EQ),(12,EQ),(16,EQ),(888,EQ))

16. CODIGOS DE RETORNO DOS PROGRAMAS (RETURN CODES) DA PROCEDURE


STEPNAME - RETURN-CODES - DESCRICAO/ACAO
SSSP111A – 3,4,5,6,7 - NAO HAH REMESSA PARA TRANSMISSAO
SSSP111A – 10 - IDEM
SSSP111A - >15 - ERRO NA GERACAO DO ARQUIVO,
NAO DEVERA SER TRANSMITIDO
SSSP999 - <> 11 - CONSIDERAR COMO ERRO,
EXECUTAR ROTINA DE RECUPERACAO PARA
GERACAO DE NOVO CADASTRO.
SSSP999 - 5 - CONSIDERAR COMO NORMAL
SSSP999 - 6 - CONSIDERAR COMO ERRO
SSSP888 - 2 - NAO SERAO EXECUTADOS OS STEPS X E Y.

17. ARQUIVOS RECEBIDOS


SSSF001 – DESCRICAO DO ARQUIVO
DO RJ, EMPRESA DE SEGUROS, CDT
SSS002 – DESCRICAO DO ARQUIVO
DO B3, PXXXE999, FTS
SSSF003 – DESCRICAO DO ARQUIVO
DO SILO XXXX, PSSSW777, FTS

18. ARQUIVOS ENVIADOS


COE210 - CORREIO SISBB CONTENDO XXX.
PARA A BASE DO APLICATIVO COE
SSSF111 - DESCRICAO DO ARQUIVO
DE BR PARA PSSSD001 EM BR
DE RJ PARA PSSSD999 EM B3
SSSF222 - DESCRICAO DO ARQUIVO
TRANSMITIDOS PARA A EMPRESA EEEEE VIA TTTT
SSSF333 - DESCRICAO DO ARQUIVO
DE B3 PARA PSSSD001 DO SILO XXXXX VIA FTS
DE HM PARA PSSSD999 DO SILO XXXXX VIA FTS

;
Padrão para Documentação de Procedures GPROM6 131029 Página 34 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

19. INSTRUCOES PARA GERENCIAMENTO


AMBIENTE: BR - HORARIO: 02:00 - NIVEL: ALTO
ATRASO: INICIO
MOTIVO DA CRITICIDADE: TRANSFRENCIA FECHAMENTO COMPE NO BACEN.
TEXTO LIVRE DAS COLUNAS 29 A 70.
TEXTO LIVRE DAS COLUNAS 29 A 70.
TEXTO LIVRE DAS COLUNAS 29 A 70.
PROVIDENCIAS: COMUNICAR O CSO COMPE PARA EXECUTAR O FECHAMENTO
PARCIAL.
TEXTO LIVRE DAS COLUNAS 20 A 70.
TEXTO LIVRE DAS COLUNAS 20 A 70.

AMBIENTE: BR - HORARIO: 03:00 - NIVEL: BAIXO


ATRASO: FIM
MOTIVO DA CRITICIDADE: TRANSFRENCIA FECHAMENTO COMPE NO BACEN.
PROVIDENCIAS: COMUNICAR O CSO COMPE PARA EXECUTAR O FECHAMENTO
PARCIAL.

20. INSTRUCOES EM CASO DE ABEND


ANTES DE REINICIAR A PROCEDURE, EXECUTAR A ROTINA PSSSE001 PARA
RECUPERACAO DO ARQUIVO LIDER.
EXCLUIR DO PROCESSAMENTO O ARQUIVO BBN.SSS999.* (LIDO NO STEP
STEP01) QUE CONTIVER REGISTROS TRUNCADOS.
RESTART-CONDICIONAL: NO STEP SSSSSS, VERIFICAR MENSAGEM DO PGM.
EM CASO DE FIM ANORMAL NO STEP SSSSSSS, EXECUTAR A PROCEDURE
PSSSE999, REINICIANDO EM SEGUIDA.

21. INSTRUCOES PARA REPROCESSAMENTO


DELETAR OS ARQUIVOS BBN.SSS111 TRANSMITIDOS E REINICIAR A ROTINA
A PARTIR DO STEP SSSSSSSS.

22. INSTRUCOES PARA MIGRACAO


EM CASO DE MIGRACAO MASSIFICADA DE CONTAS ENTRE AGENCIAS,GRI/DEB
INFORMAR EM D+1 PARA O DD CARTAO O ARQUIVO CONTENDO OS PREFIXOS

23. INSTRUCOES PARA CONTINGENCIA


EXECUTAR A ROTINA INFORMANDO O MONITOR DB2 ATIVO NA PARTICAO PPP.

24. RELATORIOS
A) RELATORIO: SSS777
TITULO: TRANSACOES REJEITADAS POR CLIENTE
CONTEUDO: QUANTIDADE DE REGISTROS GRAVADOS, REJEITADOS E
PERCENTUAL DE REJEICAO POR CLIENTE.
FORMULARIO: 0.30.300-0 NR. COPIAS: 1 SALTO: 6601
FREQUENCIA: DIARIA PROGRAMA:SSSP888
DESCARBONAR: NAO - SEPARAR: NAO - CORTAR: NAO
ARQUIVO: &HLQ..SSS.SSSF777A.D&DTMOV..SS000104
EH PERMITIDO REFAZIMENTO: SIM
FORMA DE REFAZIMENTO: FMT
DESTINATARIOS: AGENCIAS
FORMA DE DISPONIBILIZACAO: UTF, IRA E GDR.
CANAL1: 1AAAASSSSSNNNNN

B) RELATORIO: SSS888
TITULO: TRANSACOES ACEITAS POR CLIENTE
CONTEUDO: QUANTIDADE DE REGISTROS GRAVADOS, REJEITADOS E
PERCENTUAL DE REJEICAO POR CLIENTE.
FORMULARIO: 0.30.300-0 NR. COPIAS: 1 SALTO: 6601
FREQUENCIA: DIARIA PROGRAMA:SSSP888
DESCARBONAR: NAO - SEPARAR: NAO - CORTAR: NAO
ARQUIVO: &HLQ..SSS.SSSF888A.D&DTMOV..SS000104
EH PERMITIDO REFAZIMENTO: SIM
FORMA DE REFAZIMENTO: FMT
DESTINATARIOS: AGENCIAS

;
Padrão para Documentação de Procedures GPROM6 131029 Página 35 de 41
PROCESSO DE DESENVOLVIMENTO DE APLICATIVOS
Padrão para Documentação de Procedures

FORMA DE DISPONIBILIZACAO: GDR E IRA


CANAL1: 1AAAASSSSSNNNNN

25. CARDLIB
SSSP999A - DESCRICAO EM TEXTO LIVRE DA COLUNA 17 ATE A COLUNA 70.
SSSP999B - DESCRICAO EM TEXTO LIVRE DA COLUNA 17 ATE A COLUNA 70.
SSSP999C - DESCRICAO EM TEXTO LIVRE DA COLUNA 17 ATE A COLUNA 70.

26. LINHAS EXCLUIDAS DA VERSAO ANTERIOR


10. PROVIDENCIAS COMPLEMENTARES - JOB
D) SSSD999D:
//*-------------------------------------------------------------*
//SYS000A EXEC PGM=SYS000
// PARM='&CDP..SSS.SSSF180.D&DTMOV..SS310801'
//*-------------------------------------------------------------*
//PDB2E880 EXEC PDB2E880,
// A=G,
// AMB=BR,
// OBJ=UNLD999,
// ORD=&ORDERID,
// PART=,
// SIS=EVT
//UNLOAD.SYSRE1 DD DSN=&CDP..SSS.SSSF180.D&DTMOV..SS310801,
// SPACE=(CYL,(150,50),RLSE),DISP=(,CATLG)
//*-------------------------------------------------------------*
11. PARAMETROS SIMBOLICOS DA PROCEDURE - OBRIGATORIOS
DTANT - DATA DO MOVIMENTO ANTERIOR NO FORMATO AAMMDD.

27. INSTRUCOES EXCLUSIVAS AOS DESENVOLVEDORES DO SISTEMA


ESTA PROCEDURE E REFERENTE A INTERVENCAO NO SISTEMA XXX PARA
CONTEMPLAR A NOVA CLASSIFICACAO DE CLIENTE PARA O BANCO.

;
Padrão para Documentação de Procedures GPROM6 131029 Página 36 de 41
4.2 Exemplo por silo de aplicação

01. HISTORICO
VRS004-04/04/04-CCCCCCCC-(FULANO)-MOTIVO MOTIVO MOTIVO MOTIVO X
MOTIVO MOTIVO MOTIVO. X
CCCCCCCC-(CICRANO)-MOTIVO MOTIVO MOTIVO MOTIVO X
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO, X
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO. X
VRS003-03/03/03-CCCCCCCC-(BELTRANO)-MOTIVO MOTIVO MOTIVO MOTIVO
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO,
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO.
VRS002-12/02/02-CCCCCCCC-(BELTRANO)-MOTIVO MOTIVO MOTIVO MOTIVO
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO,
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO.
02/02/02-CCCCCCCC-(CICRANO)-MOTIVO MOTIVO MOTIVO MOTIVO
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO
MOTIVO MOTIVO MOTIVO MOTIVO MOTIVO.
VRS001-01/01/01-CCCCCCCC-(FULANO)-IMPLANTACAO.

02. IDENTIFICACAO
APLICATIVO - SSS - NOME DO APLICATIVO CONFORME DPR
PROCEDURE - PSSSD999

03. FINALIDADE
GERACAO DO ARQUIVO XXXF101 CONTENDO A DEPENDENCIA SUBORDINADORA
POR DEPENDENCIA, ANO-MES E TOTALIZACAO.

04. AMBIENTES E PERIODICIDADES


SILO FINANCAS
PRODUCAO: DIARIA – TODOS OS DIAS UTEIS
HOMOLOGACAO: DIARIA – TODOS OS DIAS UTEIS

05. HORARIOS DE EXECUCAO


PRODUCAO: 12:00 HORAS
RESTRICAO:ALTA
MOTIVO: JOB FAZ TRANSMISSAO DE ARQUIVO PARA O BANCO
CENTRAL AS 12:00.
HOMOLOGACAO: 17:00 HORAS

06. PROCEDURES EXECUTADAS ANTES


PRODUCAO: PSSSD001 E PSSSD002
HOMOLOGACAO: PSSSD111 E PSSSD222

07. CONDICOES PARA INICIAR A EXECUCAO


PRODUCAO: RETURN CODE DO STEP SSSP000 DA PROCEDURE PSSSP001
IGUAL A 0 OU 4.
HOMOLOGACAO: NIHIL

08. RECURSOS UTILIZADOS


DB2, FTS, ADABAS, CICS, FTP, GRI, RVS, CDT

09. PROVIDENCIAS COMPLEMENTARES


A) TEXTO1 TEXTO1 TEXTO1 TEXTO1.
TEXTO1 TEXTO1 TEXTO1 TEXTO1.

B) TEXTO2 TEXTO2 TEXTO2 TEXTO2.


TEXTO2 TEXTO2 TEXTO2 TEXTO2.
TEXTO2 TEXTO2 TEXTO2 TEXTO2.

C) TEXTO3 TEXTO3 TEXTO3 TEXTO3

10. PROVIDENCIAS COMPLEMENTARES - JOB


A) SSSD999A:
EM PRODUCAO E HOMOLOGACAO, ANTES DA PSSSD999, EXECUTAR
O JOB ABAIXO, QUE TEM POR FINALIDADE FAZER UNLOAD DA
TABELA XXX_YYY_ZZZ. ESSE JOB NAO PODERAH SER EXECUTADO
SIMULTANEAMENTE COM O JOB SSSD999B.
//*-------------------------------------------------------------*
//SYS000A EXEC PGM=SYS000,
// PARM='&HLQ..SSS.SSSFXXX1.D&DTMOV.SS000101'
//*-------------------------------------------------------------*
//PDB2E888 EXEC PDB2E888,
// MEMBRO01=&MEMBRO01,
// A=&A,
// C=&C,
// CONS=,
// CREATOR=DB2SIS,
// CSTT=,
// DRCT=NO,
// HLQ=&HLQ,
// JOBNAME=&JOBNAME,
// OBJ=S1SSS001,
// OPCAO='NEW/RESTART',
// ORD=&ORDERID,
// S=&S,
// SHLV=,
// SHRL=,
// SIS=SSS,
// TABLE='XXX_YYY_ZZZ'
//SYS108C.SYSUT1 DD DSN=&CARDLIB(SSSD999C),DISP=SHR
//*------------------------------------------------------------*
ONDE:
A - PRODUCAO: DATA-SHARING DO DB2
HOMOLOGACAO: DATA-SHARING DO DB2

C - PRODUCAO: DATA-SHARING DO DB2


HOMOLOGACAO: DATA-SHARING DO DB2

MEMBRO01 – PRODUCAO: MEMBRO01=MEM1


HOMOLOGACAO: MEMBRO01=MEM2

B) SSSD999B:
EM PRODUCAO E HOMOLOGACAO, APOS O FIM NORMAL DA PSSSD999,
EXECUTAR O JOB ABAIXO, QUE TEM POR FINALIDADE FAZER LOAD
NA TABELA XXX_YYY_ZZZ.
//*-------------------------------------------------------------*
//PDB2E999 EXEC PDB2E999,
// MEMBRO01=&MEMBRO01,
// A=&A,
// CARDLIB=&CARDLIB,
// CONS=,
// CREATOR=DB2SIS,
// CSTT=,
// DIS=9,
// DRCT=NO,
// DSNREC=&HLQ..SIS.SISF999R.D&DTMOV..SS000101,
// HLQ=&HLQ,
// JOBNAME=&JOBNAME,
// LIB=&CICSLIB,
// NEW=99999,
// OBJ=S1SSS999,
// OPCAO='NEW/RESTART',
// ORD=&ORDERID,
// S=&S,
// SHLV=,
// SHRL=,
// SIS=SSS,
// SYSPUNCH=&HLQ..SIS.SISF999P.D&DTMOV..SS000101,
// TAB='XXX_YYY_ZZZ',
// TIPO=2
//*-------------------------------------------------------------*
//SYS0000A EXEC PGM=SYS000,
// PARM='&HLQ..SIS.SISF999P.D&DTMOV..SS000101'
//*-------------------------------------------------------------*
//SYS0000B EXEC PGM=SYS000,
// PARM='&HLQ..SIS.SISF999R.D&DTMOV..SS000101'
//*-------------------------------------------------------------*
ONDE:

A - PRODUCAO: DATA-SHARING DO DB2


HOMOLOGACAO: DATA-SHARING DO DB2

S - PRODUCAO: DATA-SHARING DO DB2


HOMOLOGACAO: DATA-SHARING DO DB2

MEMBRO01 – PRODUCAO: MEMBRO01=MEM1


HOMOLOGACAO: MEMBRO01=MEM2

11. PARAMETROS SIMBOLICOS DA PROCEDURE - OBRIGATORIOS


BBM - HLQ DOS DSN DOS ARQUIVOS BBM.

CARDLIB - PARTICIONADO QUE CONTEM OS CARTOES DE CONTROLE


UTILIZADOS PARA A EXECUCAO DOS PROGRAMAS.

CICSLIB - BIBLIOTECA DE MODULOS DO CICS.

DB - BASE DE DADOS DOS MODULOS NATURAL.

DB2 - DATA-SHARING DO DB2 EM 04 DIGITOS.

DEST - CODIGO DE DESTINO DO ARQUIVO SSS610.


PRODUCAO: DEST=BR
HOMOLOGACAO: DEST=HM

DESTCOE - SIGLA DE DESTINO PARA NET067 PARA O ARQUIVO COE210.

DESTFI - SIGLA DE DESTINO PARA NET067 PARA OS ARQUIVOS XPT111


E XPT222.

DESTNST - SIGLA DE DESTINO PARA NET067 PARA O ARQUIVO NTS100

DTMOV - DATA DO MOVIMENTO NO FORMATO 'AAMMDD'

HLQ - HIGH-LEVEL-QUALIFIER DOS DSN DOS ARQUIVOS DE DADOS

OUTRO - FORCA A GRAVACAO DO NUMERO DA REMESSA NO HEADER DO ARQUIVO XXX999


PRODUCAO: OUTRO=SIM
HOMOLOGACAO: OUTRO=NAO

12. PARAMETROS SIMBOLICOS DA PROCEDURE - OPCIONAIS


BF...E - PARAMETRO BUFNO DOS ARQUIVOS DE ENTRADA

BF...S - PARAMETRO BUFNO DOS ARQUIVOS DE SAIDA

FTSRJE - ARQUIVO DE CONTROLE DE TRANSMISSAO FTS


ASSUME: FTSRJE=BBN.FTSRJE.CNTLMST

PARM001 - PARAMETRO UTILIZADO NO PROGRAMA SSSPC123


INFORMAR PARM001=SIM QUANDO SOLICITADO PELO XXXXX
INFORMAR PARM001=NAO QUANDO SOLICITADO PELA AGENCIA
ASSUME: PARM001=X999S1

PLAN - PLANO DA BASE DE DADOS NO DB


ASSUME: PLAN=PSSS9999

QR...P - QTD DE REGISTROS PARA ALOCACAO PRIMARIA EM DISCO

QR...S - QTD DE REGISTROS PARA ALOCACAO SECUNDARIA EM DISCO

13. PARAMETROS DE PROGRAMAS (PARM) DA PROCEDURE


SSSP001 - PARM=X999S1. NO PROCESSAMENTO DIARIO.
PARM=SIM. MEDIANTE SOLICITACAO DO XXXXX, GERAR
RELATORIO SSS999 DE EMISSAO MENSAL EM DIA QUE NAO
FOR O ULTIMO DIA UTIL DO MES.
SSSP002A - PARM=X88881. NO PROCESSAMENTO MENSAL.
PARM=SIM. MEDIANTE SOLICITACAO DO XXXXX,
GERAR RELATORIO SSS888 DE EMISSAO MENSAL EM DIA
QUE NAO FOR O ULTIMO DIA UTIL DO MES.
14. PARAMETRO REGION DO JOB PARA EXECUCAO DA PROCEDURE
REGION=4M

15. PARAMETRO COND DO JOB PARA EXECUCAO DA PROCEDURE


COND=((8,EQ),(12,EQ),(16,EQ),(888,EQ))

16. CODIGOS DE RETORNO DOS PROGRAMAS (RETURN CODES) DA PROCEDURE


STEPNAME - RETURN-CODES - DESCRICAO/ACAO
SSSP111A – 3,4,5,6,7 - NAO HAH REMESSA PARA TRANSMISSAO
SSSP111A – 10 - IDEM
SSSP111A - >15 - ERRO NA GERACAO DO ARQUIVO,
NAO DEVERA SER TRANSMITIDO
SSSP999 - <> 11 - CONSIDERAR COMO ERRO,
EXECUTAR ROTINA DE RECUPERACAO PARA
GERACAO DE NOVO CADASTRO.
SSSP999 - 5 - CONSIDERAR COMO NORMAL
SSSP999 - 6 - CONSIDERAR COMO ERRO
SSSP888 - 2 - NAO SERAO EXECUTADOS OS STEPS X E Y.

17. ARQUIVOS RECEBIDOS


SSSF001 – DESCRICAO DO ARQUIVO
DO RJ, EMPRESA DE SEGUROS, RVS
SSS002 – DESCRICAO DO ARQUIVO
DO B3, PXXXE999, FTS
SSSF003 – DESCRICAO DO ARQUIVO
DO SILO XXXX,PSSSW888, FTS

18. ARQUIVOS ENVIADOS


COE210 - CORREIO SISBB CONTENDO XXX.
PARA A BASE DO APLICATIVO COE, POR FTS
SSSF111 - DESCRICAO DO ARQUIVO
DE BR PARA PSSSD001 EM BR, POR FTS
DE RJ PARA PSSSD999 EM B3, POR FTS
SSSF222 - DESCRICAO DO ARQUIVO
TRANSMITIDOS PARA A EMPRESA EEEEE VIA TTTT
SSSF333 - DESCRICAO DO ARQUIVO
DE B3 PARA PSSSD001 DO SILO XXXXX, POR FTS
DE HM PARA PSSSD999 DO SILO XXXXX, POR FTS

19. INSTRUCOES PARA GERENCIAMENTO


AMBIENTE: PRODUCAO - HORARIO: 02:00 - NIVEL: ALTO
ATRASO: FIM
MOTIVO DA CRITICIDADE: TRANSFRENCIA FECHAMENTO COMPE NO BACEN.
PROVIDENCIAS: COMUNICAR O CSO COMPE PARA EXECUTAR O FECHAMENTO
PARCIAL.

AMBIENTE: HOMOLOGACAO - HORARIO: 03:00 - NIVEL: BAIXO


ATRASO: INICIO
MOTIVO DA CRITICIDADE: TRANSFRENCIA FECHAMENTO COMPE NO BACEN.
PROVIDENCIAS: COMUNICAR O CSO COMPE PARA EXECUTAR O FECHAMENTO
PARCIAL.

20. INSTRUCOES EM CASO DE ABEND


EXECUTAR A ROTINA PSSSE001 PARA RECUPERACAO DO ARQUIVO LIDER,
ANTES DE REINICIAR A PROCEDURE.
EXCLUIR DO PROCESSAMENTO O ARQUIVO BBN.SSS999.*, LIDO NO STEP
STEP01, QUE CONTIVER REGISTROS TRUNCADOS.
RESTART-CONDICIONAL NO STEP SSSSSS, VERIFICAR MENSAGEM DO PGM.
EM CASO DE FIM ANORMAL NO STEP SSSSSSS, EXECUTAR A PROCEDURE
PSSSE999, REINICIANDO EM SEGUIDA.

21. INSTRUCOES PARA REPROCESSAMENTO


DELETAR OS ARQUIVOS BBN.SSS111 TRANSMITIDOS E REINICIAR A ROTINA
A PARTIR DO STEP SSSSSSSS.
22. INSTRUCOES PARA MIGRACAO
EM CASO DE MIGRACAO MASSIFICADA DE CONTAS ENTRE AGENCIAS,GRI/DEB
INFORMAR EM D+1 PARA O DD CARTAO O ARQUIVO CONTENDO OS PREFIXOS MIGRADOS.

23. INSTRUCOES PARA CONTINGENCIA


EXECUTAR A ROTINA INFORMANDO O MONITOR DB2 ATIVO NA PARTICAO PPP.

24. RELATORIOS
A) RELATORIO: SSS777
TITULO: TRANSACOES REJEITADAS POR CLIENTE
CONTEUDO: QUANTIDADE DE REGISTROS GRAVADOS, REJEITADOS E
PERCENTUAL DE REJEICAO POR CLIENTE.
FORMULARIO: 0.30.300-0 NR. COPIAS: 1 SALTO: 6601
FREQUENCIA: DIARIA PROGRAMA:SSSP888
DESCARBONAR: NAO - SEPARAR: NAO - CORTAR: NAO
ARQUIVO: &HLQ..SSS.SSSF777A.D&DTMOV..SS000104
EH PERMITIDO REFAZIMENTO: SIM
FORMA DE REFAZIMENTO: FMT
DESTINATARIOS: AGENCIAS
FORMA DE DISPONIBILIZACAO: UTF, IRA E GDR.
CANAL1: 1AAAASSSSSNNNNN

B) RELATORIO: SSS888
TITULO: TRANSACOES ACEITAS POR CLIENTE
CONTEUDO: QUANTIDADE DE REGISTROS GRAVADOS, REJEITADOS E
PERCENTUAL DE REJEICAO POR CLIENTE.
FORMULARIO: 0.30.300-0 NR. COPIAS: 1 SALTO: 6601
FREQUENCIA: DIARIA PROGRAMA:SSSP888
DESCARBONAR: NAO - SEPARAR: NAO - CORTAR: NAO
ARQUIVO: &HLQ..SSS.SSSF888A.D&DTMOV..SS000104
EH PERMITIDO REFAZIMENTO: SIM
FORMA DE REFAZIMENTO: FMT
DESTINATARIOS: AGENCIAS
FORMA DE DISPONIBILIZACAO: GDR E IRA
CANAL1: 1AAAASSSSSNNNNN

25. CARDLIB
SSSP999A - DESCRICAO EM TEXTO LIVRE DA COLUNA 17 ATE A COLUNA 70.
SSSP999B - DESCRICAO EM TEXTO LIVRE DA COLUNA 17 ATE A COLUNA 70.
SSSP999C - DESCRICAO EM TEXTO LIVRE DA COLUNA 17 ATE A COLUNA 70.

26. LINHAS EXCLUIDAS DA VERSAO ANTERIOR


10. PROVIDENCIAS COMPLEMENTARES - JOB
D) SSSD999D:
//*-------------------------------------------------------------*
//SYS000A EXEC PGM=SYS000
// PARM='&CDP..SSS.SSSF180.D&DTMOV..SS310801'
//*-------------------------------------------------------------*
//PDB2E880 EXEC PDB2E880,
// A=G,
// AMB=BR,
// OBJ=UNLD999,
// ORD=&ORDERID,
// PART=,
// SIS=EVT
//UNLOAD.SYSRE1 DD DSN=&CDP..SSS.SSSF180.D&DTMOV..SS310801,
// SPACE=(CYL,(150,50),RLSE),DISP=(,CATLG)
//*-------------------------------------------------------------*
11. PARAMETROS SIMBOLICOS DA PROCEDURE - OBRIGATORIOS
DTANT - DATA DO MOVIMENTO ANTERIOR NO FORMATO AAMMDD.

27. INSTRUCOES EXCLUSIVAS AOS DESENVOLVEDORES DO SISTEMA


ESTA PROCEDURE E REFERENTE A INTERVENCAO NO SISTEMA XXX PARA
CONTEMPLAR A NOVA CLASSIFICACAO DE CLIENTE PARA O BANCO.

You might also like