Activation de la création d'enregistrements SMF (System Management Facility)

Outre les fichiers journaux, Wazi Deploy prend en charge l'utilisation de la fonction SMF (System Management Facility) à des fins d'audit et de comptabilité.

Des enregistrements SMF de type 122 et de sous-type 4 peuvent être créés pour chaque déploiement.

Activer la collecte d'enregistrements SMF dans SMFPRMxx

La fonction SMF (System Management Facility) utilise SYS1.PARMLIB(SMFPRMxx) pour déterminer les types d'enregistrement et les sous-types à collecter. Définissez SMF=xx dans le membre parmlib IEASYSxx pour spécifier le membre parmlib SMFPRMxx à utiliser lors de l'IPL.

Wazi Deploy crée des enregistrements SMF de type 122, sous-type 4.

Mettez à jour la définition SYS(TYPE()) dans SMFPRMxx pour collecter des enregistrements de type 122.

Les définitions SMFPRMxx mises à jour peuvent être activées dynamiquement (jusqu'au prochain démarrage du système (IPL)) avec la commande de console suivante :
SET SMF=xx

Pour plus d'informations sur les définitions parmlib, consultez le document « Initialization and Tuning Reference » (Référence d'initialisation et de réglage) d' MVS ( SA22-7592 ). Pour plus d'informations sur les exemples de commandes de console, voir Commandes système MVS (SA22-7627).

Autoriser la création d'enregistrements SMF

L'ID utilisateur qui exécute Wazi Deploy doit être autorisé à écrire un enregistrement SMF. Pour ce faire, accordez à l'utilisateur l'accès en lecture (READ) au profil BPX.SMF dans la classe FACILITY de votre logiciel de sécurité. Les exemples de commandes RACF suivants définissent le profil et accordent l'autorisation requise à l'ID utilisateur userid:
RDEFINE FACILITY BPX.SMF UACC(NONE)
PERMIT BPX.SMF CLASS(FACILITY) ID(userid) ACCESS(READ)
SETROPTS RACLIST(FACILITY) REFRESH
RLIST FACILITY BPX.SMF ALL

Pour plus d'informations sur les commandes RACF , voir RACF Command Language Reference (SA22–7687).

Présentation des enregistrements SMF

Le sous-type 4 de l'enregistrement SMF de type 122 est créé par Wazi Deploy lors d'un déploiement.

Le sous-type 4 de l'enregistrement SMF de type 122 comporte toujours une section d'en-tête qui est suivie d'une ou de plusieurs sections de données:

Section d'en-tête

La section d'en-tête pour le type d'enregistrement SMF 122, sous-type 4, contient un en-tête SMF standard suivi de zones qui font référence aux différentes sections de données. Les chaînes de caractères sont en EBCDIC, sont alignées sur la gauche et sont complétées par des blancs.

Tableau 1. Enregistrement SMF de type 122, sous-type 4, section d'en-tête
Décalages Type/Valeur Longueur Nom Description
0 (x0) Structure 24 SMFHDR ** En-tête SMF standard **
0 (x0) Structure 4 SMFRDW ** descripteur d'enregistrement SMF **
0 (x0) Non signé 2 SMFLEN Longueur d'enregistrement. Cette zone et la zone suivante (total de 4 octets) forment le descripteur d'enregistrement (RDW), qui est supprimé lorsque l'enregistrement est vidé.
2 (x2) Non signé 2 SMFSEG Descripteur de segment étendu. Cette zone et la zone précédente (total de 4 octets) forment le descripteur d'enregistrement (RDW), qui est supprimé lorsque l'enregistrement est vidé.
4 (x4) Chaîne de bits 1 SMFFLG Octet d'indicateur d'en-tête SMF.
  .1......   SMSSTV (x40) Les sous-types sont utilisés.
5 (x5) Non signé 1 SMFRTY Type d'enregistrement : 122 (x7A)
6 (x6) Non signé 4 SMFTME Temps écoulé depuis minuit, en centièmes de seconde, depuis que l'enregistrement a été déplacé dans la mémoire tampon SMF (format : HHMMSSth).
10 (xA) Décimale condensée 4 SMFDAT Date à laquelle l'enregistrement a été déplacé vers la mémoire tampon SMF. Au format 0cyydddF, où c a pour valeur 0 pour 19xx et 1 pour 20xx, yy représente l'année en cours (0-99), ddd représente le jour actuel (1-366) et F représente le signe.
14 (xE) EBCDIC 4 SMFSID Identification du système (à partir du paramètre d'ID source SMF).
18 (x12) EBCDIC 4 SMFWID ID du sous-système.
22 (x16) Non signé 2 SMFSTP Sous-type d'enregistrement: 4 (x4)
24 (x18)        
24 (x18) Structure 20 SMF122t4h_Head ** En-tête spécifique SMF de type 122, sous-type 4 **
24 (x18)   4   -- description d'en-tête
24 (x18) Non signé 2 SMF122t4h_Len Longueur d'en-tête spécifique au type SMF 122, sous-type 4. Elle est définie sur la taille de SMF122t4h_Head.
26 (x1A) Non signé 2 SMF122t4h_Cnt Nombre de triplets de section de données. IL s'agit du nom de blocs d'identificateur de section de données qui suivent.
28 (x1C) Structure 8   -- triplet pour la section de données 1 (exécution)
28 (x1C) Non signé 2 SMF122t4h_S1Len Longueur de la section. Elle est définie sur la taille de SMF122t4s1_Section.
30 (x1E) Non signé 2 SMF122t4h_S1Cnt Nombre de sections. Cette zone documente le nombre de fois où cette section est présente dans l'enregistrement (peut avoir la valeur 0). Si ce nombre est supérieur à 1, toutes les sections sont consécutives.
32 (x20) Non signé 4 SMF122t4h_S1Offset Décalage de la section. Décalage de ce bloc de section à partir du début de l'enregistrement.
36 (x24) Structure 8   -- triplet pour la section de données 2 (utilisation future)
36 (x24) Non signé 2 SMF122t4h_S2Len Longueur de la section. Elle est définie sur la taille de SMF122t4s2_Section.
38 (x26) Non signé 2 SMF122t4h_S2Cnt Nombre de sections. Cette zone documente le nombre de fois où cette section est présente dans l'enregistrement (peut avoir la valeur 0). Si ce nombre est supérieur à 1, toutes les sections sont consécutives.
40 (x28) Non signé 2 SMF122t4h_S2Offset Décalage de la section. Décalage de ce bloc de section à partir du début de l'enregistrement.
44 (x2C)        

Section de données 1, Déploiement exécuté

La section de données 1 pour le type d'enregistrement SMF 122, sous-type 4, identifie Wazi Deploy lui-même et l'ID utilisateur qui exécute le déploiement.

Tableau 2. Enregistrement SMF de type 122, sous-type 4, section de données 1
Décalages Type/Valeur Longueur Nom Description
0 (x0) Structure 24 SMF122t4s1_Section ** section 1 (exécution) **
0 (x0) EBCDIC 8 SMF122t4s1_User ID utilisateur
8 (x8) EBCDIC 11 SMF122t4s1_Name Nom du produit
19 (x13) EBCDIC 5 SMF122t4s1_Version Version du produit