Escolar Documentos
Profissional Documentos
Cultura Documentos
MANUAL DE ORIENTAÇÃO
E UTILIZAÇÃO - PARTE I
ULOG
UQ
USPOOL
Navegação entre Sessões COM-PLETE
Este documento tem uso destinado a todo Pessoal Técnico e aos Analistas que
fazem uso dos utilitários e funcionalidades do COM-PLETE.
Versão 1.00.1004
CONHECENDO O COM-PLETE:
Antes de se proceder com o acesso e uso dos utilitários, vamos conhecer um pouco da ferramenta
COM-PLETE.
O COM-PLETE é:
- Multitransacional
- Isolamento entre programas (via threads)
- Serviços distribuídos
Resumindo:
1- ULOG
O primeiro passo é inicializar a ferramenta que dá acesso ao COM-PLETE em seu computador, seja ela um
Emulador ou o próprio Terminal 3270.
O Emulador iniciará a negociação e estabelecerá a conexão com o ambiente Mainframe de sua empresa. Caso
isso não ocorra, entre em contato com o apoio técnico da sua empresa para configuração e solução do problema.
Esse Manual subentende que está sendo utilizado um Emulador 3270 qualquer (os quadros são baseados no
Entire Connection for Windows, da SAG, em ambiente MVS da Consist, em São Paulo), pois estes podem
apresentar uma interface quase gráfica e muito mais amigável ao treinando.
Cada empresa certamente apresentará sua tela de inicialização com formatos e nomes diferentes.
Vamos considerar que a aplicação COM-PLETE já está disponível para o usuário na sua tela de Terminal ou
Emulador, independente dos meios para chegar até ela.
A Tela inicial da ferramenta COM-PLETE nos apresenta seu primeiro utilitário: o ULOG.
Este utilitário é responsável pelo logon e controle de acesso aos recursos da ferramenta. O acesso e as
permissões são definidos pelos usuários administradores do COM-PLETE.
Figura 1
A tela de LOGON também poderia se apresentar com o formato abaixo, dependendo da configuração do
ambiente, e apresentar outra opção de conexão.
É a facilidade da reconexão automática da sessão, após uma queda de LINK com o ambiente operacional.
Antes desta implementação, no caso de queda do LINK, a USERID ficava ativa no sistema e necessitava da
intervenção do suporte para desativar a sessão antes de um novo LOGON pelo usuário. Agora, a conexão é
restabelecida automaticamente, sem essa intervenção.
Figura 2
Figura 3
Agora sim, aparecerá a Tela principal do COM-PLETE que possui o nome de COM-PASS (Figura 4).
A Tela de COM-PASS possibilita o acesso a todas as aplicações disponíveis sob o COM-PLETE (Ex.: Natural,
Editor (UEDIT), etc...).
Em algumas configurações essa tela pode não ser exibida, também. Por razões de segurança ou critérios dos
setores de suporte, os usuários finais podem ser direcionados diretamente para as aplicações, sem passar pela
tela do COM-PASS.
No caso deste Manual, apenas algumas aplicações serão exibidas na tela.
Embora várias estejam disponíveis, este manual é segmentado e apresentará cada utilitário separadamente.
Figura 4
Na Tela abaixo (Figura 5) temos 3 regiões destacadas:
Região 1: Onde estarão apresentadas as tarefas em execução, ou seja, as sessões do COM-PLETE. Aquelas
Aplicações ou Utilitários em que o usuário está trabalhando no momento.
Até 9 sessões podem ser suspensas (para este usuário só é permitido até 6 sessões), e aparecerão
numeradas nesta Região.
Região 2: Apresenta algumas das aplicações disponíveis para o usuário. Algumas aplicações podem ser
disponibilizadas e não aparecerem nesta região. Esse mapa é configurado em tempo de
criação do perfil do usuário, grupo ou do ambiente. Você será informado pelo suporte quais
aplicações podem ser executadas, mesmo que não apareçam nesta região.
Região 3: É a posição da linha de comando do COM-PASS. É aqui que os comandos diretos são digitados
para execução.
Outros pontos de entrada de comandos diretos serão mencionados no devido tempo.
É também na Região 3 que entraremos com os comandos de acesso direto aos utilitários.
Região 1 Região 2
Região 3
Figura 5
ACESSANDO APLICAÇÕES e UTILITÁRIOS
2- UQ
Inicialmente veremos o utilitário UQ, de uso muito comum e que permitirá acesso ao SPOOL do JES (fila de
execução de JOBS, relatórios emitidos, mensagens do sistema operacional resultantes das submissões destes
JOBS, e outras).
Sua inicialização é através do nome da aplicação (ou a letra correspondente (ID) na região 2), digitada na
linha de comando do COM-PLETE (região 3).
Pode-se usar *UQ, UQ ou a letra associada na Região 2, do COM-PLETE, no nosso caso a letra D.
Figura 6
A tela abaixo (figura 7), mostra as opções disponíveis para o utilitário UQ.
Neste exemplo, mostra-se como devem ser combinadas algumas das opções disponíveis para acesso ao
SPOOL, após a submissão de um JCL por alguma aplicação Natural ou por JCL direto.
Na página seguinte, será apresentada uma relação resumida dos comandos e as suas opções mais
utilizadas pelos usuários ao longo de seus trabalhos.
Figura 7
Aplicação UQ
COMANDO DESCRIÇÃO:
. Principais Keywords:
Função Q:
Função S:
IMPORTANTE:
Fazendo uso destes comandos (que devem ser estudados e fixados pelos usuários), apresentaremos
um exemplo de sua utilização, a partir dos comandos apresentados na Tela anterior (Figura 7).
Partindo do princípio que o JOB já foi submetido ao JES, e de acordo com esses comandos,
solicitamos ao utilitário UQ o seguinte:
Caso o JOB tenha executado corretamente, a Tela seguinte (Figura 8) será devolvida pelo UQ:
Resultado do UQ da figura 8.
OBS: Algumas das informações exibidas no rodapé desta Tela serão comentadas mais à frente, neste manual.
Figura 8
Caso o JOB ainda esteja em execução, a Tela será diferente, e não apresentará o COND.
Neste caso, a tela será conforme a Figura 9, abaixo:
Sucessivos ENTER de tempos em tempos, atualizarão a tela, que se modificará quando o JOB encerrar.
Figura 9
Ao término da execução do JOB, a tela da figura 10, abaixo, será exibida.
Nela, a mudança da QUEUE de “*X” para O, indica que o JOB já executou e está disponível para OUTPUT
tendo gerado um total de 402 linhas.
Nestes casos, a navegação passa a ser DIRETA, com a digitação das funções e suas opções diretamente na
tela apresentada pelo UQ. Podemos até voltar ao menu dirigido, como na figura 12, mas não seria eficiente
pelo fato de que são poucos comandos, e no modo direto se ganha em agilidade.
Figura 10
No caso do uso de comandos diretos, a primeira coluna da primeira linha da tela, é reservada para uso de
tais comandos pelo UQ (e todos os utilitários COM-PLETE), ou seja, todo comando TEM de iniciar naquela
posição e poderá se estender até onde for necessário, naquela linha.
No exemplo a seguir (figura 11), utilizamos a opção S, de seleção única e o comando SI=SM (apenas como
ilustração, pois SI=SM é o DEFAULT do sistema).
Figura 11
A Tela abaixo (figura 12), é o resultado daquela seqüência de comandos anteriores.
Sucessivos ENTER executam a paginação (SCROLL) das telas, apresentando todas as linhas da saída do JOB.
Tente lembrar dos comandos e opções disponíveis para a aplicação UQ, relacionados nas páginas anteriores, e
que nos permitem executar outras funções de navegação com mais eficiência e rapidez.
Figura 12
A tela a seguir (figura 13), mostra uma régua de opções ativas para essa saída.
Nela, podemos observar algumas das opções destacadas nas páginas anteriores, e que serão muito usadas
pelos usuários.
Destacamos:
Sucessivos ENTER mostram as mudanças durante a navegação dentro desta saída de JOB
Figura 13
Após alguns ENTER, a Tela a seguir (figura 14), já apresenta algumas mudanças. Destaque para:
Figura 14
Aqui, a Tela da figura 15, apresenta outras mudanças.
Destacamos:
Figura 19
De qualquer parte de onde estejamos na navegação, sempre poderemos utilizar a posição de entrada de
comandos (a partir da Primeira Coluna, Primeira Linha), para nos direcionarmos para onde quer que
queiramos. Isso significa que podemos digitar qualquer comando do UQ, e nos posicionar em qualquer
parte da SYSOUT do sistema (ou da aplicação), assim como podemos digitar outros comandos, como será
visto logo a seguir.
Assim, se após visualizarmos um relatório e estivermos posicionados, por exemplo, na SYSOUT da aplicação,
conforme a tela abaixo (figura 16), e quisermos voltar para a JOBLOG, bastaria digitar na posição de
comando a seguinte seqüência: SI=SM, e teclar ENTER.
Figura 16
A tela seguinte (figura 17), mostra o resultado.
Após nos certificarmos de que o relatório (aquele da Figura 16), está conforme o solicitado, poderemos destiná-
lo para impressão.
No exemplo a seguir, a JOBLOG foi destinada para uma impressora denominada PRTCELPE.
OBS: O usuário deverá obter de sua gerência, ou de outra gerência responsável, a localização física das
impressoras conectadas com o COM-PLETE, e disponíveis para emissão dos relatórios BATCH
na rede de TP do seu ambiente.
PT=PRTCELPE
Figura 17
Caso a impressora preferencial do usuário não seja a destinação daquele relatório, o COM-PLETE faz a
inicialização da tela onde se controla a destinação dos relatórios, e algumas de suas características.
A figura 18, abaixo, apresenta essa tela.
Por padrão, e por ser a forma mais comum, apenas será necessário definir se a DISPOSITION do relatório será
para:
Caso haja necessidade de mais de uma cópia, a opção COPIES será usada (0=1 impressão; 1=2 impressões)
Após o ENTER, o relatório é enviado para a impressora definida no campo DESTINATION e impresso.
Figura 18
Por oportuno, falaremos um pouco do utilitário USPOOL, responsável pelo gerenciamento do POOL de
impressão do COM-PLETE.
3- USPOOL
Todas as funções do utilitário USPOOL são acionadas via menu. Ao entrar no USPOOL aparecerá a seguinte
tela (Figura 19):
Figura 19
Funções:
A função LIST QUEUE (LQ) mostra a fila (queue) de relatórios, por impressoras, pendentes de impressão.
A função PRINTER OVERVIEW (PO) permite ao usuário emitir comandos de controle para as impressoras.
OBS: Por ser uma função para uso por profissional de perfil mais especializado, evite o seu uso, pois
poderá causar a perda de relatórios ou extravio dos mesmos, por utilização equivocada .
Figura 20
Neste exemplo, não há nenhum relatório na fila aguardando impressão (vide box na parte superior da tela),
indicando “NO PRINTOUT QUEUED”.
As funções permitidas estão destacadas no box realçando a parte inferior da tela, e são detalhadas conforme
o que se segue:
USPOOL: Campos de Operação, funções e seus significados
CAMPO UTILIZAÇÃO
Uma delas é a possibilidade de se gerar sessões de trabalho independentes, sem a necessidade de se ter
mais de um monitor ou computadores conectados. Na verdade, podemos dizer que o COM-PLETE oferece
sessões paralelas em um único computador, e em uma única sessão de emulação.
Isso nos permite, por exemplo, navegar nas aplicações para disparar um JOB, e, sem sair da aplicação,
monitorar a execução deste JOB no SPOOL do JES. Depois, alternar entre as duas sessões até que a
atividade fim tenha sido concluída.
Os comandos que nos permite esse tipo de navegação e alternância entre sessões COM-PLETE são
inicializados pelos caracteres < e =.
Exemplo: Você tem 3 sessões ativas. Está na sessão 2. Quer ir para a sessão 3.
Na sessão 2 você digita: =3. Isso mantém suspensa a sessão 2 e remete você para a sessão 3.
Na sessão 3 você quer voltar para a sessão 2, basta digitar == (você é direcionado para a
sessão anterior, não importando se não lembrar ou não souber o nº dela).
OBS: Esses caracteres deverão ser SEMPRE digitados na primeira posição de entrada de dados de qualquer
aplicação, seja ela COM-PLETE, seja Aplicação de usuário, ou o quê for. Caso contrário o recurso
não funcionará (a aplicação ativa provavelmente dará erro de entrada de dados).
O erro ocorrerá porque o COM-PLETE faz a interpretação da primeira posição de dados digitada. Caso
não seja um dos caracteres especiais de controle, ele interpreta como sendo dados da aplicação, e não executará
nem a suspensão nem a re-chamada.
Esses caracteres são escolhidos pelo administrador do COM-PLETE (no caso, estes são o padrão). Caso
alguma aplicação faça uso destes caracteres para algum controle, eles poderão ser alterados para manter o
recurso disponível, sem entrar em choque com a aplicação
A tela abaixo (figura 21), mostra os caracteres que permitem o uso deste recurso. Esses são definidos pelo
Administrador do COM-PLETE.
Podem ser diferentes, variando de uma instalação para outra.
Figura 21
Apresentaremos um exemplo prático deste recurso do COM-PLETE, e as telas resultantes dele.
Figura 22
Após navegar pela aplicação e disparar o JCL para execução, o usuário deseja ver a fila do JES, mas não quer
encerrar a aplicação, pois poderá necessitar retornar a ela.
A tela a seguir (figura 23), mostra a execução com sucesso da etapa de submissão do JOB da função do IM.
Figura 23
Na seqüência, é digitado o sinal de menor (<), solicitando a suspensão desta sessão para o COM-PLETE.
Na tela abaixo, o caractere (<) está digitado na linha de comando da aplicação. As aplicações Natural, em
geral, tratam a linha de comando antes das entradas de opções em tela. E o COM-PLETE reconhece isso.
Abaixo na figura 24, após o ENTER, o COM-PLETE poderá suspender essa sessão.
<
Figura 24
O COM-PLETE então volta a apresentar sua tela do COM-PASS, onde as aplicações estão definidas, porém já
se apresenta uma sessão ativa na Região 1, região anteriormente referenciada logo no inicio deste Manual.
Note a referência a aplicação CEL232, o nome do sistema ativo IM10801, e o nível 1 onde está suspenso.
O asterisco (*) indica que era a última sessão suspensa pelo usuário. Até 9 sessões podem ser suspensas no
COM-PLETE. Para este usuário da tela há a restrição de apenas 6 sessões.
Figura 25
Continuando com nosso exemplo, se o usuário digitar o comando:
Figura 26
Daí, basta iniciar os RECALLS (re-chamadas entre os níveis suspensos), através dos sinais de = repetidos
(==), que o COM-PLETE executa os SWITCHS entre esses níveis.
Com isso ele navega ora na aplicação UQ, ora na Aplicação Natural, no caso de nosso exemplo.
Figura 27
Após o (==) da figura 27 anterior, a aplicação ativa passa a ser o Natural, com o sistema IM.
Figura 28
Outro (==), na figura 29 abaixo, no sistema IM ...
Figura 29
E o COM-PLETE volta ao UQ.
Após concluir a monitoração do SPOOL, direcionado o relatório para a impressora, e encerrado as atividades
na aplicação, o usuário vai encerrar a sessão remota (e todas as sessões abertas no COM-PLETE).
Na tela abaixo (figura 30), o usuário pode suspender a sessão ativa, com o comando (<).
<
Figura 30
O COM-PLETE volta a sua tela principal. No caso, a tela do COM-PASS.
Podemos observar que agora há 2 níveis de suspensão: um com a aplicação Natural como visto anteriormente,
nível 1, e outro com o UQ, no nível 2.
Esse de nível 2 é que foi o último nível ativo (veja o * ao lado).
Figura 31
Uma das formas de se encerrar essas sessões é inserindo o sinal - (menos), à frente na coluna NAME, na
primeira posição, exatamente sobre o nome que se apresenta naquela coluna, em cada nível suspenso.
Figura 32
Após o ENTER, as sessões já estão encerradas (figura 33, abaixo).
Essa talvez seja a maneira mais ágil de se encerrar sessões suspensas, quando ainda se quer continuar a
execução de alguma outra tarefa no ambiente conectado, que não necessite de nenhuma das sessões que
estavam abertas anteriormente.
Figura 33
Porém, se não há mais tarefas a executar e é hora de encerrar as atividades na conexão, o comando mais
simples é o mesmo apresentado abaixo:
LOGOFF ou ULOG (ou uma letra associada na tela do COM-PASS, caso haja)
Esse comando encerra as sessões suspensas e a sessão COM-PLETE no ambiente operacional, conectada através
do Emulador ou diretamente no Terminal.
Figura 34
Alguns comandos, funcionalidades e dicas de uso destes utilitários abordados deixaram de ser apresentadas neste
trabalho, apenas por não serem de uso muito comum. Caso haja necessidades adicionais ou orientação em outras
funcionalidades dos utilitários abordados, esclarecimentos de dúvidas ou aumento de recursos para otimização de
trabalho e maior capacitação no uso da ferramenta, entre em contato com a gerência de sua empresa e solicite
esse apoio. A Consist permanecerá à disposição.
As dúvidas oriundas dos textos deste manual poderão ser dirimidas junto aos Consultores, Gerentes e Técnicos
da Consist em todo País, ou junto aos Analistas de Suporte de sua empresa que participaram dos treinamentos
avançados.