ZINFOS4-TSS ( R$TRAP ) - z1fo4.com · Le résultat des commandes est stocké dans un fichier...

V1 SP0

ZINFOS4-TSS

( R$TRAP ) et utilitaires

Guide Utilisateur

26 février 2012

ZINFOS4-TSS Guide Utilisateur Réf: ZTSS_USTRAP-02 R$TRAP

et Utilitaires Conservation de commandes TSO, TSS,

et divers

Date: 26/02/2012

V1 SP0

Copyright © 2012 Z1FO4

/ 56

Produit ZINFOS4-TSS – R$TRAP (outil de conservation de commandes TSO, …)

Version V1 SP0

Document-Type Guide Utilisateur

Référence ZTSS_USTRAP-02

Dernière mise à jour documentation 24/02/2012

Fichier ZINFOS4-TSS_V1SP0_R$trap_UserGuide.doc



et divers

Date: 26/02/2012

V1 SP0


/ 56

1. TABLE DES MATIERES

1. TABLE DES MATIERES ........................................................................................................................................................ 3

2. INTRODUCTION ..................................................................................................................................................................... 5 2.1. BUT DU DOCUMENT .............................................................................................................................................................. 5 2.2. FONCTIONS ET POSSIBILITES ................................................................................................................................................. 5 2.3. CONVENTION D’ECRITURE .................................................................................................................................................... 6

3. UTILISATION DE R$TRAP SOUS ISPF .............................................................................................................................. 7 3.1. PANNEAU D’ENTREE DES COMMANDES ................................................................................................................................. 8

3.1.1. Description des champs d’informations et zones de saisies ........................................................................................ 9 3.2. PANNEAU D’AFFICHAGE DES RESULTATS ............................................................................................................................ 10 3.3. COMMANDES DE GESTION AVEC R$TRAP ........................................................................................................................... 11

3.3.1. Commande : VERSION ............................................................................................................................................. 11 3.3.2. Commande : TFILE ................................................................................................................................................... 12 3.3.3. Commande : SORT .................................................................................................................................................... 13

3.3.3.1. Tri par « libellé de commande » ............................................................................................................................................... 13 3.3.3.2. Tri par « date » .......................................................................................................................................................................... 14

3.3.4. Commande : FIND .................................................................................................................................................... 15 3.3.5. Commande : BATCH ................................................................................................................................................. 16 3.3.6. Commande : LISTVAR .............................................................................................................................................. 19 3.3.7. Commande : PROF ................................................................................................................................................... 20 3.3.8. Commande : EXPORT............................................................................................................................................... 21 3.3.9. Commande : IMPORT ............................................................................................................................................... 23 3.3.10. Commandes spéciales ou réservées aux (L)SCAs ..................................................................................................... 25

3.3.10.1. Commande : DEBUG ........................................................................................................................................................... 25 3.3.10.2. Commande : VIEWCMD (réservé aux (L)SCAs) ............................................................................................................... 26

3.3.10.2.1. Table des commandes BATCH ........................................................................................................................................ 28 3.4. COMMANDES ET INTERFACES SUPPLEMENTAIRES DISPONIBLES .......................................................................................... 29

3.4.1. Utilisation d’une commande MVS ............................................................................................................................. 30 3.4.2. Utilisation de l’API SDSF : $ISF .............................................................................................................................. 31 3.4.3. Utilisation de la commande LADM ........................................................................................................................... 32 3.4.4. Utilisation de la commande LUALL .......................................................................................................................... 33 3.4.5. Utilisation de la commande LINFO .......................................................................................................................... 34 3.4.6. Utilisation des commandes LBKP, LWHOH et LTSO ............................................................................................... 34 3.4.7. Utilisation de la commande FREEUID ..................................................................................................................... 35 3.4.8. Utilisation de la commande FREEGID ..................................................................................................................... 36 3.4.9. Z4TSS : interface de commande TSS à usage restreint ............................................................................................. 37

3.4.9.1. Z4TSS : Utilisation directe ....................................................................................................................................................... 37 3.4.9.1. Z4TSS : Utilisation étendue ...................................................................................................................................................... 39

4. UTILISATION DE R$TRAP EN BATCH ........................................................................................................................... 42 4.1. DESCRIPTION DU JCL ......................................................................................................................................................... 42

4.1.1. Les paramètres d’appel du R$trap ............................................................................................................................ 43 4.1.1.1. Le paramètre CMDTRAP ......................................................................................................................................................... 43 4.1.1.2. Le paramètre NUMTRAP ......................................................................................................................................................... 43 4.1.1.3. Le paramètre SCHAR ............................................................................................................................................................... 43 4.1.1.4. Le paramètre ICMD .................................................................................................................................................................. 43 4.1.1.5. Le paramètre DDN .................................................................................................................................................................... 43 4.1.1.6. Le paramètre RDISP ................................................................................................................................................................. 44 4.1.1.7. Le paramètre MAXCC .............................................................................................................................................................. 44 4.1.1.8. Le paramètre MAILTO ............................................................................................................................................................. 44 4.1.1.9. Le paramètre MAILMSG .......................................................................................................................................................... 44

4.1.2. Compte-rendu d’exécution du R$trap ....................................................................................................................... 45



et divers

Date: 26/02/2012

V1 SP0


/ 56

4.1.3. Exemple de fichier résultat ........................................................................................................................................ 46 5. UTILITAIRES ET MODULES ADDITIONNELS ............................................................................................................. 47

5.1. PROGRAMMES A UTILISER SOUS TSO/ISPF ........................................................................................................................ 47 5.1.1. Edit-Macro R$exec (à exécuter en EDIT ou VIEW mode) ....................................................................................... 47 5.1.2. Edit-Macro R$tssrpt (à exécuter en EDIT ou VIEW mode) ..................................................................................... 48 5.1.1. Edit-Macro àSub (à exécuter en EDIT ou VIEW mode) ......................................................................................... 49 5.1.2. Pgm R$smfmon .......................................................................................................................................................... 50

5.2. PROGRAMMES REXX A UTILISER EN BATCH ................................................................................................................... 51 5.2.1. Pgm $JCLSYMB ........................................................................................................................................................ 51 5.2.2. Pgm LTSS$PR1 ......................................................................................................................................................... 52 5.2.3. Pgm LTSS$CMD ....................................................................................................................................................... 53 5.2.4. Pgm LTSS4DIV ......................................................................................................................................................... 55 5.2.5. Pgm LTSS4RPT ......................................................................................................................................................... 56



et divers

Date: 26/02/2012

V1 SP0


/ 56

2. INTRODUCTION

2.1. But du document

Ce document décrit les principes et possibilités du module ZINFOS4-TSS de gestion des

commandes sous TSO, développé pour faciliter l’administration.

Par convention on le nommera R$TRAP.

2.2. Fonctions et possibilités

Le module « R$TRAP » permet d’exécuter, de stocker et de restituer des commandes ainsi que

les résultats associés. Ces commandes peuvent être de natures différentes, cela dépend des

interfaces externes implémentées. Par défaut toute commande TSO peut être exécutée. On peut

connaître la liste des interfaces supplémentaires disponibles qui sont fournis par R$TRAP en

tapant la commande « ?? » .

Le module est prévu pour fonctionner en interactif et/ou en BATCH.

Les Utilitaires et les modules additionnels :

• R$EXEC Edit-macro permettant entre autre l’exécution directe de commandes TSS

• R$TSSRPT Edit-macro permettant de récupérer les noms des fichiers TSS (Secfile,Recfile,

Audit, fichiers de vidages ,…)

• àSUB Edit-macro permettant de soumettre du JCL avec utilisation de « system-symbol » .

• R$SMFMON Programme permettant de connaitre en temps réel les taux de remplissage des

fichiers SMF (utile pour l’exécution du rapport TSSOERPT).

• LTSS$CMD, LTSS$PR1, LTSS4DIV et LTSS4RPT sont des programmes BATCH permettant

d’émettre des rapports, d’effectuer des sélections ou de formater des données pour effectuer du

Post-traitement de commandes TSS.



et divers

Date: 26/02/2012

V1 SP0


/ 56

2.3. Convention d’écriture

• Le symbole ↵ indique que l’on appuie sur la touche du clavier en émulation 3270

correspondant à la fonction « Entrée ».

• Le symbole PF3 indique que l’on appuie sur la touche du clavier en émulation 3270 « F3 »

correspondant à la touche de fonction ISPF« PF3 » qui doit correspondre à la commande

ISPF « END ».



ISPF « EXIT ».



ISPF « DOWN ».

• La valeur &Hlq correspond à l’alias utilisé pour l’application ZINFOS4-TSS.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3. UTILISATION DE R$TRAP SOUS ISPF

L’appel de R$TRAP s’effectue par le menu principal ZINFOS4-TSS, ou plus simplement en

tapant « R$T » depuis la zone de commande de n’importe quel écran (à condition que l’appel au

programme soit intégré aux « ISPCMDS » ).

Attention car si vous faites cet appel depuis SDSF, certaines commandes peuvent ne pas

être reconnues.

Les commandes que vous émettez sont stockées dans une table contenue dans votre profil

ISPF sous le nom « R$TSOL ».

Chaque commande est conservée avec un « timestamp » , un compteur d’exécution et le

dernier code-retour reçu.

Le résultat des commandes est stocké dans un fichier séquentiel LRECL=250.

Lors de la première utilisation le fichier résultat est créé et alloué.

La localisation du fichier est modifiable par l’utilisateur.

Si vous faites plusieurs appels de R$TRAP sur des écrans différents, les appels successifs

stockent les résultats dans un fichier temporaire qui est détruit en quittant R$TRAP.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.1. Panneau d’entrée des commandes

4 Option valide en mode BATCH

2 Partition en cours

3 Zone d’affichage des messages

5 Zone d’entrée des commandes

6 Zone de sélection d’une commande

7 Nombre de lignes maximum à conserver pour l’affichage

8 Mode d’exécution ISPF ou BATCH

9 Mode d’affichage du résultat : BROWSE, VIEW ou EDIT

10 Zone des commandes de gestion

1 Acronyme société

11 Niveau du logiciel de sécurité

12 Environnement ZINFOS4-TSS



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.1.1. Description des champs d’informations et zones de saisies

1. L’acronyme de la société affiché ici Z1FO , correspond à la variable renseignée lors de l’installation initiale du produit.

2. La partition z/OS en cours n’est pas une zone modifiable par l’utilisateur, ce

champ apparaît également sur l’écran de consultation du résultat. 3. La zone d’affichage des messages affiche au démarrage de R$trap la valeur

du nom de l’utilisateur. 4. Cette zone permet d’émettre de multiples commandes, à condition de

sélectionner le mode BATCH. Dans ce cas, un JCL apparaît à l’écran afin de saisir la liste des commandes souhaitées.

5. C’est la zone principale du R$trap, vous devez saisir les commandes à

exécuter dans ce champ.

6. Ce champ permet de sélectionner, de supprimer ou d’obtenir de l’information sur une commande déjà stockée par R$trap. La sélection recharge la commande dans la zone principal du R$trap décrite en 5 .

7. Le nombre de lignes maximum à stocker pour l’affichage du résultat est fixé

lors de l’installation du produit, mais peut être modifié par chaque utilisateur, par le biais de la commande de gestion des variables utilisateur : Commande PROF.

8. Cette zone permet d’exécuter une commande sous ISPF (défaut) ou en

BATCH. Il faut impérativement taper la commande avant de sélectionner cette zone. On peut écrire I pour ISPF et B pour BATCH indifféremment en majuscule ou minuscule.

9. Ce champ permet de sélectionner le mode d’affichage BROWSE, VIEW ou

EDIT. On peut écrire B pour BROWSE, V pour VIEW ou E pour EDIT indifféremment en majuscule ou minuscule. Ce choix peut être modifié de façon globale à l’installation de ZINFOS4-TSS, ou pour chaque utilisateur, par le biais de la commande de gestion des variables utilisateurs : Commande PROF.

10. Ce champ correspond à la zone de commande standard des panneaux ISPF.

Vous pouvez saisir toutes les commandes TSO/ISPF ainsi que des commandes de gestion spécifique à R$trap (exemple commande PROF).

11. Ce champ indique le niveau du logiciel de sécurité présent sur le site. Cette

information est valable pour TSS, RACF et ACF2.

12. Le code environnement correspond à la normalisation établie à l’installation du produit.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.2. Panneau d’affichage des résultats

Le type d’affichage est lié au champ n° 9 « ISPF-mode » du panneau d’entrée des commandes : Browse, View ou Edit. L’exemple ci-dessous présente l’affichage en mode VIEW. Le principe reste le même pour les autres modes.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3. Commandes de gestion avec R$trap

3.3.1. Commande : VERSION

Cette commande d’information permet de connaître la version en cours de « ZINFOS4-TSS » ainsi que d’autres modules comme R$trap.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3.2. Commande : TFILE

Cette commande permet de vérifier le nom du fichier d’affichage des résultats.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3.3. Commande : SORT Cette commande permet de trier les commandes stockées, soit par Date, soit par libellé de commande (en Ascendant ou en Descendant).

3.3.3.1. Tri par « libellé de commande » Par défaut le tri s’effectue en Ascendant

Il suffit juste de taper « sort d » pour obtenir le même tri mais en Descendant.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3.3.2. Tri par « date » Par défaut le tri par « date » s’effectue en Descendant (les plus récentes en premier).

Pour obtenir le même tri en Ascendant (commandes les plus anciennes en premier). Il suffit de taper « sort date a ».



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3.4. Commande : FIND Pour utiliser cette commande vous devez commencer par désactiver

« le tri automatique après chaque commande » disponible par la commande PROF.

Il est possible d’effectuer une recherche de chaîne de caractères dans la table des commandes stockées. La chaîne de caractères trouvée est en 1ère ligne de la table. La commande RFIND n’étant pas disponible dans l’environnement R$trap, vous devez rappeler votre commande manuellement si vous souhaitez répéter votre commande plusieurs fois.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3.5. Commande : BATCH Comme indiqué sur le panneau d’entrée des commandes, il est possible d’émettre de façon ponctuelle une commande R$trap en BATCH en précisant : « Exec-mode BATCH ». L’exécution de la commande est traitée par un JOB effectuant un TSO BATCH. Il est possible de consulter le résultat du JOB afin de connaître le nom du fichier contenant le résultat de votre commande. Exemple :



et divers

Date: 26/02/2012

V1 SP0


/ 56

Pour connaître le nom du JOB vous devez appuyer sur la touche de fonction PF1.

Une fois le Notify de fin de JOB reçu, vous pouvez tapez la commande BATCH :



et divers

Date: 26/02/2012

V1 SP0


/ 56

Utilisez la Sélection et effectuez une pagination directement vers la fin du JOB pour consulter le report d’exécution de R$trap.

Il est conseillé d’utiliser le mode BATCH pour les commandes qui nécessitent un temps d’exécution assez long. Ainsi vous ne bloquez pas votre session TSO/ISPF.

Nom du fichier contenant le résultat de la commande



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3.6. Commande : LISTVAR Cette commande permet de connaître la valeur des variables utilisées par tous les modules ZINFOS4-TSS. Ces valeurs sont communes à tous les utilisateurs et ne sont pas modifiables. Néanmoins certaines variables peuvent être spécifiques à votre session TSO/ISPF en utilisant la commande PROF.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3.7. Commande : PROF Cette commande permet la gestion de vos paramètres d’exécution personnel.

Syntaxe de l’adresse eMail dans un fichier : Zcaimanàz1fo4.com (destinataire principal) ou cc(Zcaimanàz1fo4.com) (destinataire en copie).

Remplace les défauts fixés à l’installation de ZINFOS4-TSS

Le choix Oui implique un envoi par email à chaque exécution. Il est donc prudent de désactiver cette option après utilisation.

z1fo4.com correspond à la variable fixée par défaut à l’installation de ZINFOS4-TSS.. On peut entrer plusieurs destinataires en précisant le nom d’un fichier

Identique à la commande SORT



et divers

Date: 26/02/2012

V1 SP0


/ 56

exemple de message après une commande PROF + activation de l’envoi par email.

3.3.8. Commande : EXPORT



et divers

Date: 26/02/2012

V1 SP0


/ 56

Cette commande permet d’exporter dans un fichier la totalité des commandes stockées. L’export est affiché dans le fichier de résultat sous la forme suivante :

Attention pour toute commande TSS contenant des champs de type « password »

ceux-ci sont systématiquement substitués par les caractères ‘ ???????? ‘. Cette

transformation est effectuée lors de l’exécution de la commande. Ainsi, aucun mot de

passe n’est conservé dans la table des commandes.

Date de 1ère exécution de la commande

Heure de 1ère exécution de la commande

Date de dernière exécution de la commande

Heure de dernière exécution de la commande

Commande complète d’origine

Le « + » indique que les caractères suivants correspondent à la suite de la commande.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3.9. Commande : IMPORT Cette commande à l’inverse de « l’EXPORT » utilise le fichier de résultat comme source (avec le même format) pour recharger la table des commandes. Les commandes ainsi récupérées remplacent intégralement le contenu de la table active. Exemple de fichier à importer :

On constate que les lignes 5 et 6 ne respectent pas le format crée par « EXPORT » et utilisé pour « IMPORT ». Dans ce cas la date du jour et l’heure de l’IMPORT sont pris en référence.



et divers

Date: 26/02/2012

V1 SP0


/ 56

Le résultat de l’importation montre que la table des commandes ne contient plus que 6 lignes.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3.10. Commandes spéciales ou réservées aux (L)SCAs

3.3.10.1. Commande : DEBUG

Cette commande sert uniquement en cas de problème dans le fonctionnement du

R$trap. Toutes ses fonctions ne sont pas présentées ici.

SI par exemple on constate une incohérence lors d’une commande de SORT on peut

utiliser cette commande avec l’argument DATE. Cela a pour conséquence de faire

basculer le format Date et Heure en Basedate et Basetime. Cette commande

effectue la bascule d’un format à l’autre à chaque fois qu’elle est invoquée.Il est

conseillé d’utiliser la commande DEBUG avec la personne en charge du R$trap.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3.10.2. Commande : VIEWCMD (réservé aux (L)SCAs) Cette commande permet de récupérer la copie d’une table de commandes d’un autre utilisateur et/ou provenant d’une autre machine (si les catalogues permettent l’accès aux fichiers associés). La table distante est copiée dans une table temporaire « R$TSOT » qui sert alors à l’affichage du panneau d‘entrée des commandes. Syntaxe de la commande : VIEWCMD username sysname Si aucun paramètre n’est précisé (username et sysname) la table d’origine « R$TSOL » est réaffichée. Exemple avec Username précisé : Viewcmd wtssadm



et divers

Date: 26/02/2012

V1 SP0


/ 56

Exemple avec Username et Sysname précisés : Viewcmd wtssadm z1ts

Reset vers la table d’origine : Viewcmd

L’affichage avec Viewcmd apparaît trié selon vos défauts (voir la commande « PROF »)



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.3.10.2.1. Table des commandes BATCH

La commande VIEWCMD permet également de récupérer la copie de la table des commandes R$TRAP exécutées en BATCH (cette table est commune à toutes les partitions d’un même environnement). La table BATCH est copiée dans la table temporaire « R$TSOT » qui sert alors à l’affichage du panneau d‘entrée des commandes. La table d’origine est stockée dans le PDS « &Hlq.TSSUPD.ISPCMDS » sous le nom usernameB. Cette table n’est pas modifiable. Syntaxe de la commande : VIEWCMD BATCH [ ,username ] username est une valeur optionnelle Exemple de visualisation de la table BATCH d’un autre utilisateur : Viewcmd batch,wtssadm



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.4. Commandes et interfaces supplémentaires disponibles

Des commandes spécifiques pour les environnements CA-OPS, CA-7, CA-SYSVIEW/E, TSS, MVS sont ancrées dans le code du R$trap. Cependant pour s’assurer des options réellement disponibles il faut tapez la commande « ?? » dans la zone d’entrée des commandes.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.4.1. Utilisation d’une commande MVS

Le caractère « / » est utilisé comme préfixe de toute commande MVS. Pour pouvoir exécuter une commande MVS il faut avoir un segment TSO et l’autorité TSOAUTH(CONSOLE) associé à votre identifiant TSS. De plus il est préférable d’ajouter la commande « CONSPROF » dans les AUTHCMD du membre IKJTSOnn. L’affichage produit par la commande est écrit dans le fichier de résultat de R$trap.

Néanmoins il peut arriver que R$trap ne récupère pas le résultat de certaines commandes. C’est souvent le cas d’une commande vers un sous-système spécifique dont la réponse n’est pas captée. Exemple de commande : (Liste des noms de toutes les STCs TCPIP du sysplex)



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.4.2. Utilisation de l’API SDSF : $ISF A condition que SDSF soit présent sur le site, il est possible de récupérer directement dans le R$trap des informations liés aux options « LOG, DA, H, ST » ainsi que la visualisation d’une SYSOUT. L’option « LOG » est disponible à partir de z/OS 1.1.1 . Pour obtenir la syntaxe d’appel de l’API, il suffit de taper dans la zone de commande du R$TRAP $ISF ? $Isf Help Format(s) disponible(s) ---------------------------------- $Isf log(Start-time,End-time,Maxline) HH:MM:SS,HH:MM:SS,number --> Display SYSLOG (default Start-time=08:00:00) --> SYSLOG (default Maxline=100000) ---------------------------------- $Isf da(Prefix,Owner,Sysname) --> Display DA Panel (Default all-Jobname & all-Sysname) --> '*' = parametre nul : exemple DA(*,TCPIP) --> Liste de tous les Jobnames avec le Owner=TCPIP ---------------------------------- $Isf H(Prefix,Owner,date) --> Date sous format JJ/MM/AA ou TODAY pour la date du jour --> Display Held Panel (Default Prefix by your Jobname) --> '*' = parametre nul : exemple H(*,TIDUALC) --> Liste de toutes les Sysouts avec le Owner=TIDUALC --> Il est possible d'afficher Plusieurs Owner en meme temps --> exemple H(*,TIDUALC/SAHGUDC/.....) ---------------------------------- $Isf ST(Prefix,Owner) --> Display Status Panel (Default all-Jobname) --> '*' = parametre nul : exemple ST(*,TIDUALC) --> Status de tous les JOBs avec le Owner=TIDUALC ---------------------------------- $Isf J(Jobname(JOBID)) --> Display de la SYSOUT du JOB



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.4.3. Utilisation de la commande LADM Cette commande est réservée aux administrateurs de sécurité de type (L)SCAs. Elle permet de connaître l’identifiant et le nom de l’administrateur d’un utilisateur.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.4.4. Utilisation de la commande LUALL Cette commande est réservée aux administrateurs de sécurité de type (L)SCAs. Elle permet de lister un User et tous ses profiles associés dans l’ordre d'attribution. Cet affichage correspond à l’ordre dans lequel les autorisations sont analysées par TSS (en mode override,allover).



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.4.5. Utilisation de la commande LINFO Cette commande est réservée aux administrateurs de sécurité de type (L)SCAs. Elle permet de lister le segment $INFO d’un accessorid.

3.4.6. Utilisation des commandes LBKP, LWHOH et LTSO Ces commandes sont disponibles avec l’interface RSTOSEC (cf doc RSTOSEC).



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.4.7. Utilisation de la commande FREEUID Cette commande permet d’obtenir la liste les UIDs (UserID USS) non attribués.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.4.8. Utilisation de la commande FREEGID Cette commande permet d’obtenir la liste les GIDs (Groupes USS) non attribués.



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.4.9. Z4TSS : interface de commande TSS à usage restreint

Cette interface permet à des utilisateurs habilités dans ZINFOS4-TSS d’exécuter des commandes TSS sans posséder de droit administratif de sécurité.

La mise en œuvre requiert un paramétrage spécifique (cf documentation administrateur).

Pour cette utilisation, il est préférable que l’utilisateur connaisse la syntaxe des commandes TSS. Deux possibilités sont offertes au travers de R$trap :

1. L’utilisation directe (exemple : Z4TSS LIST(AUDIT) ..) 2. L’utilisation étendue, avec possibilité de saisir plusieurs commandes de n’importe

quelle nature (List, Addto, Create, Permit, Revoke, Remove, Delete, Admin, ….)

3.4.9.1. Z4TSS : Utilisation directe

Ce mode de fonctionnement est normalement disponible pour les utilisateurs ZINFOS4-TSS de niveau (Admlvl 2 et 20) . Il y a une restriction pour le niveau (Admlvl 2), correspondant aux équipes systèmes, ou seules les commandes de « LIST et WHOHAS » sont possibles.

Puis appuyer sur ↵



et divers

Date: 26/02/2012

V1 SP0


/ 56



et divers

Date: 26/02/2012

V1 SP0


/ 56

3.4.9.1. Z4TSS : Utilisation étendue

Ce mode de fonctionnement est normalement disponible pour les utilisateurs ZINFOS4-TSS de niveau (Admlvl 20) correspondant au rôle administrateur externe.

Puis appuyer sur ↵

Mettre « Multi-Line Cmd » à la valeur « Y »

Y



et divers

Date: 26/02/2012

V1 SP0


/ 56

Puis appuyer sur PF3



et divers

Date: 26/02/2012

V1 SP0


/ 56



et divers

Date: 26/02/2012

V1 SP0


/ 56

4. UTILISATION DE R$TRAP EN BATCH

L’utilisation de R$trap en Batch permet l’exécution de multiples commandes avec création automatique d’un fichier résultat. Le programme produit un compte-rendu d’exécution et permet la gestion d’un code-retour maximum. Cette option offre la possibilité d’inclure le Step du R$trap dans un JCL plus complexe tout en gérant les anomalies.

4.1. Description du JCL

//Yourjob JOB (TSS),'TSOBATCH',CLASS=S,MSGCLASS=U, // MSGLEVEL=(1,1),NOTIFY=&SYSUID /*JOBPARM S=* //*========================================================== //S100FT01 EXEC PGM=IKJEFT01,REGION=0M //SYSPRINT DD SYSOUT=* //SYSPROC DD DISP=SHR,DSN=&HLQ..TSSUSR.ISPRLIB // DD DISP=SHR,DSN=Your-Rexx-PDS //SYSTSPRT DD SYSOUT=* //SYSTSIN DD * PROF NOPREF %R$TRAP CMDTRAP('*NONE*') NUMTRAP(100000) DDN(TEST) SCHAR(+) + RDISP(SHR) ICMD(ITSSCMD) MAILTO(ZCAIMAN.TSS.PARM(ZZZMAIL)) + MAILMSG(IMAILMSG) MAXCC(4) /* //ITSSCMD DD * TSS LIST(STC) ........ /* //IMAILMSG DD * Ceci est le texte de remplacement du message par défaut /* //*========================================================== Ce JCL est constitué d’un step invoquant un TSO/BATCH. 1. En Ddname SYSPROC, on trouve le PDS du R$trap et un PDS contenant les

éventuels Clist ou Rexx que vous pourriez appeler. 2. Un rapport d’exécution est écrit sous l’étiquette SYSTSPRT. 3. L’appel du R$trap se code sous le Ddname SYSTSIN. Les paramètres d’appel

sont codés ici en bleu. 4. Le Ddname ITSSCMD (précisé par les paramètres d’appel) permet d’entrer la liste

des commandes à exécuter. 5. Le Ddname IMAILMSG (précisé par les paramètres d’appel) permet en cas d’envoi

du résultat par mail de modifier le message d’accompagnement du fichier.

1

2 3

4

5



et divers

Date: 26/02/2012

V1 SP0


/ 56

4.1.1. Les paramètres d’appel du R$trap Les paramètres sont toujours saisis avec des parenthèses : Paramètre( valeur )

4.1.1.1. Le paramètre CMDTRAP Ce paramètre sert à préciser la commande dont on souhaite conserver le résultat dans un fichier. Cette valeur est automatiquement renseignée lorsque vous exécutez une commande en Batch depuis le R$trap sous ISPF (cf 3.3.5 ). Dans le cas présenté le paramètre doit toujours être égal à " ‘*NONE*’ ". Il n’y a pas de défaut.

4.1.1.2. Le paramètre NUMTRAP Ce paramètre a exactement la même fonction que l’appel sous ISPF. Il permet de préciser le nombre de lignes maximum que l’on veut conserver dans le fichier résultat. En batch il est conseillé d’indiquer ici une valeur assez élevée (au moins 100000 lignes).

Attention le défaut est positionné à 2000 lignes

4.1.1.3. Le paramètre SCHAR Lorsqu’une commande ne peut pas tenir en une seule ligne, il faut utiliser un caractère de continuation pour indiquer au R$trap que la ligne suivante fait partie de la même commande. Le caractère de continuation par défaut est le « + ». Mais vous pouvez choisir un autre caractère à votre convenance.

4.1.1.4. Le paramètre ICMD Ce paramètre permet de préciser la valeur du Ddname par lequel les commandes à exécuter seront entrées. Il n’y a aucun défaut mais par convention on utilisera le plus souvent « ITSSCMD » comme valeur.

4.1.1.5. Le paramètre DDN Vous pouvez préciser ici le suffixe du fichier résultat. Dans l’exemple de JCL ci-dessus le fichier se nommera donc : Votre-Userid.Machine-d-exécution.ISPF.TEST . Sinon par défaut : Votre-Userid.Machine-d-exécution.ISPF.RThhmmss .



et divers

Date: 26/02/2012

V1 SP0


/ 56

4.1.1.6. Le paramètre RDISP On précise ici la disposition du fichier résultat. Par défaut le paramètre est positionné à « SHR ». Détail des valeurs possibles : NEW Le fichier résultat est crée. Mais il ne doit pas déjà exister. SHR Le résultat est écrit en début de fichier. S’il n’existe pas il est crée. MOD Le résultat est écrit en fin de fichier. S’il n’existe pas il est crée.

4.1.1.7. Le paramètre MAXCC Par défaut la valeur du code-retour maximum considéré comme correct est « 4 ». Vous pouvez indiquer la valeur qui vous convient le mieux. Dans le cas ou une commande dépasse la valeur du Maxcc, le programme R$trap se termine avec un code retour égal à 20 .

4.1.1.8. Le paramètre MAILTO Ce paramètre n’a pas de défaut. Vous devez l’utiliser seulement si vous souhaitez envoyer le fichier résultat par eMail (en fichier attaché) à un ou plusieurs destinataires. Pour un seul destinataire on écrira directement l’adresse eMail du destinataire dans le paramètre « MAILTO(zcaimanàz1fo4.com) ». Pour indiquer plusieurs destinataires il faut préciser le nom du fichier qui contient la liste des adresses eMail. Dans un fichier il est possible de désigner des destinataires du mail en copie uniquement. Exemple : cc(zcaimanàz1fo4.com) Un seul destinataire par ligne.

4.1.1.9. Le paramètre MAILMSG Ce paramètre est optionnel, et utilisable uniquement si le paramètre MAILTO est également utilisé. Par convention on utilise la valeur « IMAILMSG » pour indiquer le Ddname du fichier contenant le texte de l’eMail. Si vous ne souhaitez pas modifier le texte du message par défaut (Le résultat se trouve dans le fichier ci-joint ), il n’est pas utile de renseigner ce paramètre.



et divers

Date: 26/02/2012

V1 SP0


/ 56

4.1.2. Compte-rendu d’exécution du R$trap Dans l’exemple ci-dessous les paramètres d’appels sont les suivants : %R$TRAP CMDTRAP('*NONE*') NUMTRAP(100000) DDN(TEST) + RDISP(SHR) ICMD(ITSSCMD) MAILTO(zcaimanàz1fo4.com) ------------------------------------------------------------------------------------ REXX Pgm R$trap Version=2.02.03 le 10 May 2006 a 10:59:38 Execution de commande(s) TSO en MODE=BATCH Lparname=Z1FO4 Sysname=Z1FO MVS-level=z/OS 01.04.00 HBB7707 TSO-level=3.03.0 User=ZCAIMAN Name=JOHN DOE ---------------------------------------------------------------------------------- Outtrap() DSN= ZCAIMAN.Z1FO.ISPF.TEST,Disp=SHR %R$s2rcom *,MAILFILE,zcaimanràz1fo4.com, ZCAIMAN.Z1FO.ISPF.TEST, 'Etat R$TRAP Batch',R$trap.txt,DEBUG R$S2RCOM-------Input-Parms--------- R$arg=* B$rep=MAILFILE B$dest=zcaimanàz1fo4.com B$dsn=ZCAIMAN.Z1FO.ISPF.TEST R$robj=Etat R$TRAP Batch B$odsn=R$trap.txt B$dbg=DEBUG ----------------------------------------------------------------------------------- Jesnode=Z1FO4 TRANSMIT N2.SMTP DATASET('ZCAIMAN.R$S2RCOM.JOB46843.D732440.M39580') NOEPILOG NOLOG NOPROLOG RC=0 Max-lines-to-trap=100000 Exec-cmd-multiples=4 via DDN=ITSSCMD Continuation caractere='+' code-retour-Max=8 - code-retour-Max-autorise=4 Exec-CMD=TSS MODIFY ST RC-CMD=0 Exec-CMD=TSS LIST(ZIGOTO) DATA(BASIC) RC-CMD=8 Exec-CMD=R$ladm wsyst01 RC-CMD=0 Exec-CMD=TSS list(audit) RC-CMD=0 Write-DDN=RT105938 - 120 Ligne(s) - code-retour=0 ------------------------------------------------------------------------------- Fin Pgm REXX RC=20 le 10 May 2006 a 10:59:40 -----------------------------------------------------------------------------



et divers

Date: 26/02/2012

V1 SP0


/ 56

4.1.3. Exemple de fichier résultat On constate que chaque commande exécutée est précisée par la ligne : **EXEC-CMD= détail de la commande



et divers

Date: 26/02/2012

V1 SP0


/ 56

5. UTILITAIRES ET MODULES ADDITIONNELS

5.1. Programmes à utiliser sous TSO/ISPF

Ces programmes sont accessibles si la bibliothèque « &HLQ..TSSUSR.ISPRLIB » du produit ZINFOS4-TSS est présente dans votre concaténation ou allouée par la commande TSO « ALTLIB » .

5.1.1. Edit-Macro R$exec (à exécuter en EDIT ou VIEW mode) Cette Edit-macro permet d’exécuter, d’envoyer, etc, le contenu du fichier édité. Pour connaître la liste des paramètres d’appel du R$exec il suffit de taper dans le champ COMMAND ===> R$exec ?

==MSG> Utilisation de l'edit macro R$exec ==MSG> Command ===> r$exec Options ==MSG> les Options possibles sont les suivantes : ==MSG> pas d'option -> exécution directe des commandes : ==MSG> £££ ATTENTION un <CAPS ON> est effectue dans ce cas sur le fichier édité. ==MSG> LC -> idem défaut sans transformation en majuscules des commandes ==MSG> MD5 -> calcul du MD5 du fichier ==MSG> MD5END -> calcul du MD5 avec ajout en fin du source ==MSG> BATCH -> exec des cmds en Batch ==MSG> BTRAP -> exec des cmds en Batch + Stockage R$trap ==MSG> PARTOUT -> exec des cmds en Batch sur toute les partitions ==MSG> d'un environnement donné avec Jobname unique ==MSG> ALLJOB -> exec des cmds en Batch sur toute les partitions ==MSG> d'un environnement donné avec Jobname différent sur chaque partition ==MSG> Mail -> envoi fichier par Mail au destinataire prédéfini ==MSG> cf commande PROF du R$trap et segment $Z1MAIL dans TSS ==MSG> ou Mail(Override-Dest-mail)

Ce programme permet donc, par exemple, d’exécuter un flot de commande TSS en l’injectant automatiquement dans un BATCH, sans se soucier de la fabrication du JCL.



et divers

Date: 26/02/2012

V1 SP0


/ 56

5.1.2. Edit-Macro R$tssrpt (à exécuter en EDIT ou VIEW mode) Cette Edit-macro permet de récupérer les noms des fichiers TSS (Secfile,Recfile, Audit,

fichiers de vidages ,…) et également les noms des fichiers SMF.

La normalisation des fichiers est renseignée lors de l’installation du produit.

Pour connaître la liste des paramètres d’appel du R$tssrpt il suffit de taper dans le champ

COMMAND ===> R$tssrpt ?

==MSG> Utilisation de l'edit macro R$tssrpt ==MSG> Command ===> r$tssrpt Options[,DSN] ==MSG> Le choix ,DSN en plus de Options affiche le résultat ==MSG> sans les DDNAMEs ==MSG> les Options possibles sont les suivantes : ==MSG> pas d'option --> insertion liste des fichiers AUDIT COPIE ==MSG> AUDITALL --> insertion AUDIT COPIE de toutes les partitions d’un même environnement ==MSG> AUDITCUM --> insertion CUMUL AUDIT du jour précédent ==MSG> SMF --> insertion Fichier SMF actif ==MSG> SMFCUM --> insertion GDGs Vidages SMF du jour ==MSG> SMFDAY --> insertion Cumul SMF du jour ==MSG> AUDIT --> insertion TSS AUDIT file *inactif* ==MSG> AUDACT --> insertion TSS AUDIT file *actif* ==MSG> RECFILE --> insertion TSS RECFILE file ==MSG> RECCUM --> insertion liste des fichiers RECOVERY CUMUL ==MSG> SECFILE --> insertion TSS SECFILE file ==MSG> BACKUP --> insertion TSS BACKUP file



et divers

Date: 26/02/2012

V1 SP0


/ 56

5.1.1. Edit-Macro àSub (à exécuter en EDIT ou VIEW mode) Ce programme permet de préparer et soumettre un JCL en substituant automatiquement les « system-symbol » . Les « system-symbol » doivent obligatoirement être assigné dans le JCL avec une carte « SET » : //label SET Your_var=&system-symbol. Pour connaitre la liste exhaustive des « system-symbol » existants, il suffit de taper dans la zone de commande du R$TRAP R$symbol LISTE En plus des symboles statiques définis sur votre site, il est donc possible d’utiliser les symboles dynamiques suivants : Name Value -------- ------------------------------------------- &YYMMDD GMT date &LYYMMDD Local date &HHMMSS GMT time &LHHMMSS Local time &MON GMT month (01-12) &LMON Local month (01-12) &DAY GMT day of month (01-31) &LDAY Local day of month (01-31) &JDAY GMT day of year (001-366) &LJDAY Local day of year (001-366) &WDAY GMT day of week (SUN, MON, TUE, WED, THU, FRI, SAT) &LWDAY Local day of week (SUN, MON, TUE, WED, THU, FRI, SAT) &HR GMT hour of day (00-23) &LHR Local hour of day (00-23) &MIN GMT minute of hour (00-59) &LMIN Local minute of hour (00-59) &SEC GMT second of minute (00-59) &LSEC Local second of minute (00-59) &JOBNAME Nom du JOB en cours &YR2 GMT year (00-99) &LYR2 Local year (00-99) &YR4 GMT year (0000-9999) &LYR4 Local year (0000-9999)

Ce programme peut être également utilisé en BATCH (cf 5.2.1 Pgm $JCLSYMB) .



et divers

Date: 26/02/2012

V1 SP0


/ 56

5.1.2. Pgm R$smfmon Ce programme permet de connaitre en temps réel les taux de remplissage des fichiers SMF. Cette information s’avère utile pour l’utilisation du rapport « TSSOERPT » qui utilise les fichiers SMF . L’appel s’effectue en tapant la COMMAND ===> tso R$smfmon



et divers

Date: 26/02/2012

V1 SP0


/ 56

5.2. Programmes REXX à utiliser en BATCH

5.2.1. Pgm $JCLSYMB Ce programme permet de soumettre un JCL en substituant automatiquement les « system-symbol » , il est appelé, soit par l’Edit-macro « àsub » , soit directement en BATCH. Un step doit être inséré dans le JCL. Ci-après deux exemples d’utilisation : //*=============================================================== //SYMBSUB1 EXEC PGM=IKJEFT01,REGION=4M, // PARM='%$JCLSYMB DD(IJCL),TSOSUB' //SYSPRINT DD SYSOUT=* //SYSPROC DD DISP=SHR,DSN=&HLQ..TSSUSR.ISPRLIB //SYSTSPRT DD SYSOUT=* //SYSTSIN DD DUMMY //* //IJCL DD DISP=SHR,DSN=Your_Jcl_To_Submit_1 //*=============================================================== //*=============================================================== //SYMBSUB2 EXEC PGM=IKJEFT01,REGION=4M, // PARM='%$JCLSYMB DD(IJCL),DD(OINTRDR)' //SYSPRINT DD SYSOUT=* //SYSPROC DD DISP=SHR,DSN=&HLQ..TSSUSR.ISPRLIB //SYSTSPRT DD SYSOUT=* //SYSTSIN DD DUMMY //* //IJCL DD DISP=SHR,DSN=Your_Jcl_To_Submit_1 //OINTRDR DD SYSOUT=(A,INTRDR) //*===============================================================

DDNAME pour lecture du JCL à soumettre

JCL à soumettre

JCL à soumettre

Le JCL est envoyé par un TSO SUBMIT

DDNAME pour lecture du JCL à soumettre

Le JCL est envoyé sur le DDNAME OINTRDR , ce qui correspond ici à « l‘Internal-Reader »



et divers

Date: 26/02/2012

V1 SP0


/ 56

5.2.2. Pgm LTSS$PR1 Ce programme permet de formater les commandes TSS pour entrer dans l’utilitaire TSSCFILE. //*=============================================================== //S100FT1B EXEC PGM=IKJEFT1B,REGION=0M,DYNAMNBR=250, // PARM='%LTSS$PR1 &paramètre(s) ’ //* ************************************************************ //* * PREPARE LA SYSIN POUR LE PGM TSSCFILE * //* ************************************************************ //SYSPRINT DD SYSOUT=* //SYSPROC DD DISP=SHR,DSN=&HLQ..TSSUSR.ISPRLIB //ITSS2DEL DD DISP=SHR,DSN=Your_Input_list //SYSTSPRT DD SYSOUT=* //OREPORT DD SYSOUT=* //OTSSCFIL DD DISP=SHR,DSN= Your_TSSCFILE_Input_sysin //SYSTSIN DD DUMMY //*=============================================================== 1) Le fichier Your_Input_list contient la liste des Acids dont on veut effectuer un TSSCFILE.

Les formats acceptés sont les suivants :

TSS LIST(Accessor-ID) DATA(……) TSS DEL(Accessor-ID) Accessor-ID Accessor-ID xxxxxxx yyyyyy /* n’importe quelle chaîne de caractère */ Accessor-ID ; xxxxxxx ; yyyyyy ; ……. * tout ce qui suit après * est considéré comme un commentaire

2) &paramètre(s) : On peut préciser tout type de mot clé accepté dans une commande « TSS LIST » Par défaut &paramètre(s) = « DATA(ALL,PASS,EXPIRE) »

3) Le fichier Your_TSSCFILE_Input_sysin contient pour chaque ligne en entrée une valeur du

type : TSS LIST(Accessor-ID) DATA( &paramètre(s) )

Valeurs du code retour du programme :

RC Explication 0 Fin correcte. Les commandes pour TSSCFILE sont bien créées. 4 Fichier en entrée vide ou inexistant

8 Erreur d'écriture sur le fichier de sortie "OTSSCFIL" ou erreur dans le format du fichier d'entrée

200 Erreur de logique interne du programme.

1

2

3



et divers

Date: 26/02/2012

V1 SP0


/ 56

5.2.3. Pgm LTSS$CMD Ce programme est utilisé pour exécuter en BATCH des commandes TSS. Les commandes en erreur sont automatiquement dirigés vers un fichier en sortie (DDname=OANOMALI) . //*=============================================================== //S100FT01 EXEC PGM=IKJEFT01,REGION=6M, // PARM='%LTSS$CMD' //SYSPRINT DD SYSOUT=* //SYSPROC DD DISP=SHR,DSN=&HLQ..TSSUSR.ISPRLIB //ITSSCMD DD * TSS LIST(ZAUDIT) TSS CRE(C1SCA) NAME('JUSTE POUR VOIR') TYPE(SCA) + PASSWORD(CPASVRAI,,EXP) TSS LIST(STC) TSS LIST(FDT) /* //SYSTSPRT DD SYSOUT=* //OANOMALI DD SYSOUT=* //OREPORT DD SYSOUT=* //SYSTSIN DD DUMMY //*=============================================================== Dans l’exemple ci-dessus les deux premières commandes n’ont pas été exécutées correctement. Contenu des DDnames : 1. SYSTSPRT *TSS-Cmdnum(0001)=TSS LIST(ZAUDIT) TSS0314E ACID DOES NOT EXIST TSS0301I LIST FUNCTION FAILED, RETURN CODE = 8 *TSS-Cmdnum(0001) RC=8 *TSS-Cmdnum(0002)=TSS CRE(C1SCA) NAME('JUSTE POUR VOIR') TYPE(SCA) PASSWORD(????????,,EXP) TSS0203E YOU ARE NOT AUTHORIZED FOR THIS TSS FUNCTION TSS0301I CREATE FUNCTION FAILED, RETURN CODE = 8 *TSS-Cmdnum(0002) RC=8 *TSS-Cmdnum(0003)=TSS LIST(STC) *TSS-Cmdnum(0003) RC=0 *TSS-Cmdnum(0004)=TSS LIST(FDT) *TSS-Cmdnum(0004) RC=0 READY END

Entrée des commandes

Retour des messages TSO

Commandes en anomalie

Rapport d’exécution



et divers

Date: 26/02/2012

V1 SP0


/ 56

2. OANOMALI TSS LIST(ZAUDIT) TSS CRE(C1SCA) NAME('JUSTE POUR VOIR') TYPE(SCA) PASSWORD(CPASVRAI,,EXP) 3. OREPORT ------------------------------------------------------------ REXX Pgm LTSS$CMD le 23 Feb 2012 a 08:53:22 Execution et controle de commande(s) TSS en BATCH Lparname=Z1FO Sysname=Z1FO MVS-level=z/OS 01.12.00 HBB7770 TSO-level=3.12.0 User=ZCAIMAN Name=Your Name ------------------------------------------------------------ TSSCMD-DDN=ITSSCMD - 0 Ligne(s) - code-retour=0 RC(8) for Cmdnum(0001) Cmd=TSS LIST(ZAUDIT) RC(8) for Cmdnum(0002) Cmd=TSS CRE(C1SCA) NAME('JUSTE POUR VOIR') TYPE(SCA) PASSWORD(????????,,EXP) Nombre total de commande(s) TSS -> 4 Nombre total de commande(s) TSS avec RC(8) -> 2 Nombre total de commande(s) TSS en anomalie -> 2 ------------------------------------------------------------ Fin Pgm REXX RC=4 le 23 Feb 2012 a 08:53:22 ------------------------------------------------------------



et divers

Date: 26/02/2012

V1 SP0


/ 56

5.2.4. Pgm LTSS4DIV Ce programme interprète le résultat d’un TSSCFILE, puis prépare des commandes « TSS LIST(Accessor-ID) DATA(BASIC,ACIDS) » .

Records du TSSCFILE analysés en entrée de programme:

0600 - Acids de Type “PROFILE” 2800 - Acids rattachés à une Zone, Division, Département ou un User-Admin 2801 - Acids rattachés à un Group ou un Profile 2007 - Acids ayant accès à la resource (avec cmd de type TSS WHOHAS …)

Les 4 valeurs ci-dessus correspondent à la valeur des paramètres du programme LTSS4DIV. La valeur par défaut est 2800 . //*========================================================= //S100CFIL EXEC PGM=TSSCFILE //* ***************************** //* * WHOH RESSOURCE * //* ***************************** //PRINT DD SYSOUT=* //OUT DD DSN=&&PROF,DISP=(,PASS), // DCB=(RECFM=VB,LRECL=300,BLKSIZE=27998), // SPACE=(CYL,(50,15),RLSE),MGMTCLAS=Your_MgmtClass //*IN DD * TSS WHOH $Z1FOAPP(LISTAPP_TCPIP) /* //*========================================================= //S110FT1B EXEC PGM=IKJEFT1B,REGION=0M, // PARM='%LTSS4DIV 2007' //* ********************************************** //* * CREATION SYSIN POUR TSSCFILE * //* ********************************************** //SYSPRINT DD SYSOUT=* //SYSPROC DD DISP=SHR,DSN=&HLQ..TSSUSR.ISPRLIB //ITSS DD DSN=&&PROF,DISP=(OLD,PASS) //SYSTSPRT DD SYSOUT=* //OREPORT DD SYSOUT=* //OTSSLIST DD DSN=&&TSSPROF,DISP=(,PASS), // DCB=(LRECL=80,RECFM=FB), // SPACE=(TRK,(15,15),RLSE),MGMTCLAS= Your_MgmtClass //SYSTSIN DD DUMMY //*=============================================================== On peut enchainer plusieurs fois un pgm TSSCFILE suivi d’un pgm LTSS4DIV . On utilisera en général en fin de traitement le programme LTSS4RPT.

Paramètres d’entrée du TSSCFILE Fichier issus du

TSSCFILE

Record TSSCFILE à traiter

Fichier pour SYSIN d’un TSSCFILE



et divers

Date: 26/02/2012

V1 SP0


/ 56

5.2.5. Pgm LTSS4RPT Ce programme permet de fabriquer un fichier au format « csv » à partir du résultat d’un TSSCFILE.

Il existe différents modèles prédéfinis pour choisir l’organisation des éléments du fichier « csv » .

Modèle Format de sortie

défaut Sysplex-name;Dept;Dept-Name;ACID;Acid-Name;Attribut;Bypass

ACIDP

Type-Acid;ACID;Acid-Name;Cre-Date;Mod-Date;Dept;Dept-Name; Div;Div-Name;Zone;Zone-Name;User-Prof;Prof-Facility;Attribut

ACID Type-Acid;ACID;Acid-Name

DETAIL Type-Acid;ACID;Acid-Name;Dept;Dept-Name;Div;Div-Name; Zone;Zone-Name ;Last-Ref;RH-info

ADETAIL ACID;Acid-Name;Type-Acid;Dept;Dept-Name;Div;Div-Name; Zone;Zone-Name ;Last-Ref;RH-info

AUDIT1 Type-Acid;ACID;Acid-Name;Dept;Dept-Name;Div;Div-Name; Zone;Zone-Name;User-Prof ;Last-Ref;RH-info

ACID2 ACID;Acid-Name;Type-Acid;Dept;Dept-Name;Div;Div-Name; Zone;Zone-Name;Cre-date;Last-used;Profile(s);(User-FDT)

Les valeurs en bleu correspondent aux modules optionnels (CA-CLEANUP et fichier RH) JCL d’exécution du programme LTSS4RPT : //*========================================================= //S170FT1B EXEC PGM=IKJEFT1B,REGION=0M, // PARM='%LTSS4RPT &RFORM' //* *********************************** //* * CREATION LISTE EN CSV * //* *********************************** //SYSPRINT DD SYSOUT=* //SYSPROC DD DISP=SHR,DSN=&HLQ..TSSUSR.ISPRLIB //ITSS DD DSN=YOUR-TSSCFILE-FILE //SYSTSPRT DD SYSOUT=* //OREPORT DD SYSOUT=* //OTSSLIST DD SYSOUT=* //IEXCLUD DD DUMMY //IINCLUD DD DUMMY //SYSTSIN DD DUMMY //*=============================================================== Le paramètre &RFORM correspond à la valeur de la colonne Modèle du tableau ci-dessus.

Si la valeur de &RFORM est nulle, alors le modèle par défaut est appliqué.

Fichier issus du TSSCFILE

ZINFOS4-TSS ( R$TRAP ) - z1fo4.com · Le résultat des commandes est stocké dans un fichier...

Documents

Transcript of ZINFOS4-TSS ( R$TRAP ) - z1fo4.com · Le résultat des commandes est stocké dans un fichier...