Guia Ambiente Mainframe Para Ensino e Pesquisa-V21

Manual do usuário - Ambiente Mainframe para Ensino e Pesquisa

Guia para conexão ao

Ambiente Mainframe para Ensino e Pesquisa

Novembro, 2010

Versão do documento 2.1

Data de release 28 de Setembro de 2009

Última Revisão 22/11/10

Nome do Arquivo Guia_Ambiente_Mainframe_para_Ensino_e_Pesquisa-2010

System Unit Parcerias Educacionais

Notas importantes:

• O objetivo desde documento é explicar os procedimentos necessários para acessar o Ambiente Mainframe para Ensino e Pesquisa e se necessário, o passo a passo para solicitar suporte ao ambiente.

• Este documento só irá abranger os tópicos necessários para as atividades de setup e configuração de acesso ao Ambiente Mainframe para Ensino e Pesquisa

• O documento não irá atender assuntos técnicos ou relacionados as técnologias em usa nas salas de aula.

Manual do usuário - Ambiente Mainframe para Ensino e Pesquisa 1

1 CONFIGURAÇÕES INICIAIS................................................................................................... 2

2 PROBLEMAS NO ACESSO?................................................................................................... 5

3 PROCEDIMENTO PARA ACESSAR O TSO........................................................................... 7

4 PROCEDIMENTO PARA ACESSAR O CICS.......................................................................... 9

5 PROCEDIMENTOS PARA ACESSAR O DB2....................................................................... 12

6 PROCEDIMENTOS E CONFIGURAÇÕES DE COBOL........................................................ 13

7 MELHORES PRÁTICAS ........................................................................................................ 15

8 SUPORTE IBM – PROCEDIMENTOS E CONTATOS .......................................................... 22

8.1 Abertura de Chamados Técnicos .............................................................................. 22

8.2 Requerimento de criação de usuários....................................................................... 22

8.3 Formas de Contato e horários de atendimento......................................................... 23

9 MANUAIS E DOCUMENTOS TÉCNICOS ............................................................................. 24

10 LINKS UTEIS E BIBLIOGRAFIA ............................................................................................ 25


1 Configurações Iniciais

Para acessar o Ambiente Mainframe para Ensino e Pesquisa são necessários um emulador (software que reproduz as funções do ambiente Mainframe em plataformas distribuídas Windows/Linux), conexão ativa a internet e um usuário valido para o acesso:

1. Para validar a conexão a internet no Windows, sigua os passos:

a. Clique em "Iniciar" > "Executar", escreva "cmd" e clique em "OK".

b. Na tela "promp de comandos do Windows" execute o seguinte comando:

ping 200.142.195.215 *onde 200.142.195.215 é o IP primário do Ambiente Mainframe para Ensino e Pesquisa.

2. Emulador, instale o software nas maquinas que serão usadas seguindo as instruções de instalação. A IBM disponibiliza o IBM Personal Communications – PCOMM, que proporciona acesso a aplicações e dados hospedados no Mainframe, para obter o software é necessário que a escola e/ou os alunos façam parte do programa IBM Academic Initiative. Outros softwares emuladores não serão suportados por este guia.

a. Abra o Personal Communication e crie uma nova sessão:

b. Type of Host: zSeries Interface: LAN Attachment: Telnet3270


c. Selecione a opção “Link Parameters” e entre com os endereços IP abaixo e clique em OK:

200.142.195.215 é o IP primário do Ambiente Mainframe para Ensino e Pesquisa.

d. Clique em OK novamente e sua conexão deverá estar configurada para acesso ao Ambiente Mainframe para Ensino e Pesquisa


3. Os usuários e senhas serão fornecidos sob demanda na formação dos cursos na escola, quando montar a turma, favor entrar em contato com um representante da parceria IBM e efetuar o pedido de usuários para seu curso.


2 Problemas no acesso?

1. Verifique o acesso à internet acessando algum endereço valido no seu browser de acesso a internet.

a. Se estiver acessando, vá para o passo 2. b. Se não estiver acessando, verifique o acesso à internet com seu provedor local.

2. Verifique o acesso ao endereço IP do Ambiente Mainframe para Ensino e Pesquisa, na tela "promp de comandos do Windows" execute o seguinte comando (vide item 1 do capitulo anterior, configurações iniciais para maiores detalhes):

ping 200.142.195.212 *onde 200.142.195.212 é o IP primário do Ambiente Mainframe para Ensino e Pesquisa.

a. Se estiver recebendo resposta positiva do comando ping, vá para o passo 3.

b. Se não estiver recebendo resposta de nenhum dos dois endereços IPs do Ambiente Mainframe para Ensino e Pesquisa, favor entrar em contato com o suporte técnico, vide capitulo 8, SUPORTE IBM – PROCEDIMENTOS E CONTATOS, para formas e horários de contato, reportar o problema informando os testes/passos anteriores ao problema.

3. Abra seu emulador e verifique se as configurações estão apontando para o IP primário 200.142.195.212 (vide item 2 do capitulo anterior, configurações iniciais para maiores detalhes) e tente conectar.

a. Se sim(conectado), você está visualizando a seguinte tela abaixo, sua conexão esta OK.

b. Se não (não conectado), desistale seu emulador utilizando o recurso "Adicionar e Remover Programas" disponível no "Painel de Controle" do Windows e re-instale, siga as orientações de configuração do capitulo anterior deste guia para configurar seu aplicativo.


4. Se o problema continuar, favor entrar em contato com o suporte técnico, vide capitulo 8, SUPORTE IBM – PROCEDIMENTOS E CONTATOS, para formas e horários de contato, reportar o problema informando os testes/passos anteriores ao problema.


3 Procedimento para acessar o TSO

1. Abra o emulador e abra a conexão ao " Ambiente Mainframe para Ensino e Pesquisa”.

2. Deixe os campos "USERID ===>" e "PASSWORD ===>" em BRANCO e apenas na linha de comando digite "D ZOSIBM" conforme abaixo e clique enter.

3. Deixe os campos "USERID ===>" e "PASSWORD ===>" em BRANCO e apenas na linha de comando digite "D ZOSIBM" conforme abaixo e clique enter.

4. Você está na tela "Projeto IBM do BRASIL/EDUCACAO EM MAINFRAME" do ao Ambiente Mainframe para Ensino e Pesquisa que dá acesso aos recursos disponíveis como TSO e CICS. Digite TSO e de enter


5. Na tela do TSO onde você ve "IKJ56700A ENTER USERID -" entre com seu UserID e de enter. Em seguida utilize sua senha conforme solicitado na tela.

6. Caso houver algum problema, favor entrar em contato com o suporte técnico, vide capitulo 8, SUPORTE IBM – PROCEDIMENTOS E CONTATOS, para formas e horários de contato, reportar o problema informando os testes/passos anteriores ao problema.


4 Procedimento para acessar o CICS

1. Siga os passos 1 e 2 do capitulo anterior “Procedimentos para acessar o TSO”

2. Você está na tela "Projeto IBM do BRASIL/EDUCACAO EM MAINFRAME" do ACADEMIC INICIATIVE que dá acesso aos recursos disponíveis como TSO e CICS. Digite LOGON (CICS) e de enter.

3. Na tela do CICS você verá "WELCOME TO CICS hh:mm:ss" utilize a tecla "Pause/Break" do seu teclado para limpar a tela do CICS e ficar com a tela toda preta.


Utilize a tecla "Pause/Break" do seu teclado para limpar a tela do CICS e ficar com a tela toda preta

4. Entre com uma transação para exucutar seu programa. Exemplo: ABCD e de enter (onde ABCD é o nome da transação que executará o programa atrelado a ela).




5 Procedimentos para acessar o DB2

1. Siga os passos do capitulo “Procedimentos para acessar o TSO

2. Na tela inicial do ISPF, selecione P para PDF.

3. A imagem abaixo mostra a tela do PDF e as opções para acessar o DB2 são 8 – DB2 (dá acesso ao SPUFI, executar comandos DB2 e etc), 9 – QMF (acesso para executar queries na tool QMF) e D – DAD (acesso ao DB2 Admin, permite ter uma visão ampla do catálogo)

4. Caso o DB2 receba alguma mensagem dizendo que o DB2 está inativo, entrar no SDSF e executar o comando PRE DB2UMSTR e depois OWNER, depois selecione a opção “ST” do SDSF.

5. Se o DB2 não aparecer ativo, execute o comando /-DB2U START DB2

6. Se você receber algum erro de SQL, procure olhar no manual para ver do que se trata o erro. As informaçoes de erros de SQL e mensagens de DB2 podem ser encontradas no link abaixo:

http://publib.boulder.ibm.com/infocenter/dzichelp/v2r2/index.jsp



6 Procedimentos e configurações de COBOL

Compilação:

1 Copiar da biblioteca SYS2.JCLLIB o JOB correspondente ao tipo de programa criado;

2 Atualizar o cartão JOB e setar as váriáveis MEMBER (nome do programa) e UNIVRSTY (nome da instituição)

3 Na Biblioeca SYS2.JCLLIB estão modêlos para execução das seguintes modalides de compilação:

• COBOL – BATCH - (COBCOMP) ; • COBOL + DB2 – (COMPDB2) ; • COBOL + CICS - (COMPCICS) ; • COBOL + DB2 + CICS – (COMPALL) ; • BMS – (COMPMAPA) ;

4 Copiar seu programa fonte para a biblioteca SYS2.nome da instituição.SOURCE;

5 As procedures não devem ser alteradas, as possíveis alterações deverão ser solicitadas ao suporte IBM.

• Não esquecer de atualizar as varíaveis como citado acima • Submeter o JOB e teclar enter. • Caso o Return code seja 0 ou 4 passar para o passo de execução, caso contrario para solução

de erros.

6 Execução:

6.1 Programas BATCH

• Copiar o JOB modelo da biblioteca SYS2.JCLLIB , de acordo com o tipo de programa a executar, sendo os JOBS nomeados conforme abaixo o EXECBAT – Programa Batch sem acesso a DB2; o EXECDB2 – Programa Batch acessando DB2;

• Ajustar o cartão STEPLIB, que deve conter DSN=SYS2.nome da instituição.LOADLIB, onde nome da instituição deve ser obrigatóriamente o mesmo utilizado no job de compilação;

• Ajustar os DDNAMES e DSNAMES de acordo com o seu programa e arquivos em disco; • No caso de programas DB2 ajustar o nome do programa e a DBRMLIB • Submeter o JOB • Acessar o SDSF e verificar o resultado da execução (Sysout / Relatórios)

6.2 Programa ONLINE

• Logar no CICS usando o comando "LOGON APPLID(CICSUNIC)" • Teclar <PAUSE/CLEAR> para limpar a tela • Digitar o nome da transação correspondente ao seu programa, conforme tabela fornecida.

7 Para que os professores e instrutores possam validar as compilações antes do inicio de cada curso, disponibilizamos programas modelo na biblioteca SYS2.SOURCE de onde poderão ser copiados e submeter os programas e avaliar se está tudo de acordo;


8 Solução de erros de compilação

• Acessar o SDSF • Localizar o ultimo JOB de compilação • Colocar um '?' na frente do job • Colocar um 'S' na frente do primeiro arquivo JESMSGLG para ver qual STEP deu ERRO • Teclar 'F3' e localizar o STEP com erro (por exemplo, COBOL) • Colocar um 'S' na frente do step COBOL • Ir paginando a compilação e localizando as linhas com erro. • Para cada linha com erro na compilação fazer as correções necessárias no seu código fonte e

após todas correções resubmeter o JOB de compilação • Voltar ao STEP 3.3


7 Melhores Práticas

1. Digitei uma senha incorreta várias vezes e agora meu acesso está bloqueado. O que devo fazer?

R - Caso isso não ocorra, favor entrar em contato com o suporte técnico, vide capitulo 8, SUPORTE IBM – PROCEDIMENTOS E CONTATOS, para formas e horários de contato, informe seu ID e solicitando a liberação do mesmo.

2. Quando tento logar no Sistema, recebo a mensagem que meu usário já está logado. O que fazer?

R - Por motivos de segurança, isso acontece quando o logoff não foi feito corretamente (por exemplo: queda da conexão ou fechamento do emulador sem logoff). Aguarde alguns minutos pois seu usuário será liberado automaticamente ou tente a opção Reconnect conforme no exemplo abaixo; Caso isso não ocorra, favor entrar em contato com o suporte técnico, vide capitulo 8, SUPORTE IBM – PROCEDIMENTOS E CONTATOS, para formas e horários de contato, informe seu ID e solicitando a liberação do mesmo.

De um enter na frente do S Reconnect

3. Não consigo acessar o sistema hoje. Será que estou fazendo alguma coisa errada?

R – Se voce já efetuou todos os passos dos capitulos 2 e 1 deste guia e continua com os mesmos problemas, é possivel que o sistema esteja em manutenção, favor entrar em contato com o suporte técnico, vide capitulo 8, SUPORTE IBM – PROCEDIMENTOS E CONTATOS, para formas e horários de contato, para maiores informações.


Como fazer reset de senhas:

Entre na opção p.6 ( ISPF), na linha de comando colocar:

Alu (usuario) password (usuario) resume


Criando um Datasets e Membros.

� Especificando a opção 3.2 no Painel de Seleção Utilitarios mostra o conjunto de dados

Use a opção de alocar (A) para criar um novo Dataset Nome do novo Dataset como no exemplo acima ( IBMSC18.Teste)


Regra geral: classes SMS,série do volume, e um dispositivo tipo pode ser deixado em branco.

Na Opçao data set name type especifique biblioteca ou PDS por um conjunto de dados Particionado que pode conter membros

Na tela abaixo mostra que o data set foi alocado.


Copiando um Datasets e Membros

� Especificando a opção 3.3 na seleção painel utilitários exibe a Mover / Copiar

Use a opção C para copiar um Data set ou membro (s),"De" (fonte) Data set e membros.



Se o S (selecione) Linha comando para identificar o membros a serem copiados

Mensagem indica membros com copiado com sucesso.


8 Suporte IBM – Procedimentos e Contatos

8.1 Abertura de Chamados Técnicos

A abertura de chamados técnicos para o time de suporte do Ambiente Mainframe para Ensino e Pesquisa deverá ser encaminhada por e-mail e/ou telefone com o formulário abaixo preenchido. O tópico 8.3 contém horários e formas de contato com o suporte:

Nome: _________________________________________

País; Cidade/UF: ________________________________________

Telefone de contato: (___) _______-_______

E-mail: ________________________________________

Instituição: ___________________________________________________________________

Data do problema: ___/___/______ Horário que ocorreu: ____:____

Descrição detalhada do problema:

Informe a maior quantidade possível de detalhes: Qual atividade você estava realizando quando ocorreu o problema? Qual a sequência de comandos? Se possível envie a tela de erro encontrada. __________________________________________________________________________________________________________________________________________________________

8.2 Requerimento de criação de usuários

O pedido de criação de usuários deverá ser feito por e-mail através do formulário abaixo e o tópico 8.3 contém horários e formas de contato com o suporte.

Nome Responsável pelos IDs: _________________________________________

País; Cidade/UF: ________________________________________

Telefone de contato: (___) _______-_______

E-mail: ________________________________________

Instituição: ___________________________________________________________________

Perfil de acessos para o Kit:

[__] Maiframe Básico [__] COBOL [__] DB2 [__] TWS [__]OMVS

[__] CICS: Quantas transações por aluno? ____ (máx. 5 transações por aluno)

Data de Inicio: ___/___/___ Data de Término: ___/___/___

Quantidade de Alunos: _____ Precisa criar IDs para os professores? (Prencher formulário para cada professor).

Observação: __________________________________________________________________


Ao solicitar a criação de um grupo de IDs para alunos, ou seja um Kit, deve-se observar os seguintes itens.

1. IDs para os professores:

• Os IDs dos professores tem permissão “special” dentro dos Kits aos quais foram associados, dessa forma cada professor deve ter 01 (um) ID por instituição. Este professor pode estar associado a um ou mais Kits, ou seja, uma ou mais turmas;

• Os professores passarão por processo de revalidação de cadastro semestral e os IDs não utilizados por um período de 06 (seis) meses serão revocados. Após 01 (um) ano sem utilização o ID será deletado, bem como seus arquivos;

• Após os arquivos serem expurgados do sistema não há possibilidade de recuperação. Caso você tenha informações sensíveis que deseja armazenar, mantenha contato com o time do suporte;

• Se você é professor e ainda não possui um acesso, entre em contato com o suporte informando os seus dados, conforme formulário indicado para solicitar a criação dos IDs.

2. IDs para os Alunos:

• A cada turma/curso aberto deve-se solicitar a criação de um Kit para os alunos de acordo com o formulário para Criação de Usuários;

• Todas as solicitações de criação de Kits devem ser realizadas pelo professor responsável pelo curso e informada a data de término do mesmo. Após a data de término os IDs dos alunos serão revocados e após 30 (trinta) dias os mesmos serão deletados do sistema;

Obs: Todas as solicitações para criação de usuário devem conter a data de término do curso. Para cada turma em treinamento deve-se criar um grupo de usuários. Caso tenha alguma informação ou necessite de orientação sobre prazos e rotinas do sistema, entre em contato com o suporte.

8.3 Formas de Contato e horários de atendimento

Atendimento no horário comercial – Segunda a sexta das 8:30 as 17:30, exceto feriados.

E-mail: [email protected]

Obs: Os e-mails enviados para MFCOMBR devem conter as informações descritas nos tópicos 8.1 e 8.2.

Atendimento emergência, fora do horário comercial - Atendimento de segunda a sexta a partir das 17:30, até as 8:30, aos finais de semana e feriados o dia todo.

A/c: Victor Allegretti

Telefone: (11) 9909-2236

E-mail: [email protected]


9 Manuais e documentos técnicos

para mensagens DFH* manual de CICS Message and Codes CICS Messages and Codes http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/download/DFHG4B04.pdf?ACTION=SAVE&DT=20080115131952 para mensagens de SQL -xxx manual de DB2 Codes DB2 V9R1 for z/OS Codes http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/download/DSNC1K15.pdf?ACTION=SAVE&DT=20090622165757 para mensagens DSN* manual de DB2 Messages DB2 V9R1 for z/OS Messages http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/download/DSNM1K15.pdf?ACTION=SAVE&DT=20090622170549 para mensagens ICH* manual de RACF Security Server RACF Messages and Codes http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/download/ICHZA690.pdf?ACTION=SAVE&DT=20080605223128 para mensagens de IMS: Messages and Codes Reference, Volume 1: DFS Messages http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/download/DFSMC1H2.pdf?ACTION=SAVE&DT=20090423173841

Messages and Codes Reference, Volume 2: Non-DFS Messages http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/download/DFSMC2H2.pdf?ACTION=SAVE&DT=20090423174508

Messages and Codes Reference, Volume 3: IMS Abend Codes http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/download/DFSMC3H2.pdf?ACTION=SAVE&DT=20090423175118

Messages and Codes Reference, Volume 4: IMS Component Codes

http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/download/DFSMC4H2.pdf?ACTION=SAVE&DT=20090423181927


10 Links uteis e Bibliografia

IBM Personal communication web site (English):

• http://www-01.ibm.com/software/network/pcomm/

Materiais do Programa Ambiente Mainframe para Ensino e Pesquisa

• https://www14.software.ibm.com/webapp/devtool/scholar/web/coursewarePickPage.do?source=ai-course-systemz

IBM Redbooks (English) – Publicações técnicas IBM disponíveis para download

http://www.redbooks.ibm.com/cgi-bin/searchsite.cgi?query=mainframe

Documents

Guia Ambiente Mainframe Para Ensino e Pesquisa-V21