Gestion des fichiers et des volumes BULL DPS...

47 F2 04UF Rev04

Gestion des fichiers et des volumes

BULL DPS 7000

UFAS-EXTENDED - Guide de l'utilisateur

GCOS 7

Logiciel

Sujet : Description du système unifié d'accès aux fichiersUFAS-EXTENDED et de sa mise en oeuvre sous GCOS 7-V7.

Observations : La révision 4 de ce document annule et remplace la révision 3 pourles utilisateurs de GCOS7-V7. La révision 3 reste valable pour laversion V6 de GCOS, ainsi que la révision 2 pour la version V5 deGCOS.

Version du logiciel : GCOS 7-AP/HPS/EXMS Version V7

Date : Février 1996

Bull Electronics Angers S.A. Bull HN Information Systems Inc.CEDOC Publication Order EntryAtelier de reprographie FAX: (508) 294-7411331, Avenue Patton MA02/423S49004 ANGERS Cedex 01 Technology ParkFRANCE Billerica, MA 01821

U.S.A.

Copyright Bull S.A., 1996

Toutes les marques citées sont la propriété de leurs titulaires respectifs.

Vos suggestions sur la forme et le fond de ce manuel seront les bienvenues. Unefeuille destinée à recevoir vos remarques se trouve à la fin du présent manuel.

La loi du 11 mars 1957, complétée par la loi du 3 juillet 1985, interdit les copies oureproductions destinées à une utilisation collective. Toute représentation oureproduction intégrale ou partielle faite par quelque procédé que ce soit, sansconsentement de l'auteur ou de ses ayants cause, est illicite et constitue unecontrefaçon sanctionnée par les articles 425 et suivants du code pénal.

Ce document est fourni à titre d'information seulement. Il n'engage pas laresponsabilité de Bull S.A. en cas de dommages résultant de son application. Descorrections ou modifications au contenu de ce document peuvent intervenir sanspréavis ; des mises à jour ultérieures les signaleront éventuellement aux destinataires.

47 F2 04UF Rev04 iii

Préface

OBJET DU MANUEL

Le présent manuel décrit le système unifié d'accès aux fichiers UFAS-EXTENDED, et samise en oeuvre sur les grands systèmes DPS 7000 fonctionnant sous GCOS 7.

UTILISATEURS CONCERNES

Ce manuel s'adresse plus particulièrement aux programmeurs COBOL, mais intéresseégalement les utilisateurs des autres langages admis sous GCOS 7.

Le lecteur doit être familiarisé avec le langage GCL ou le langage JCL.


viii 47 F2 04UF Rev04

STRUCTURE

Ce manuel comporte huit chapitres, précédés chacun d'un plan détaillé, et sept annexes :

Chapitre 1 : définit les notions de base relatives à UFAS-EXTENDED etson contexte d'utilisation sous GCOS 7.

Chapitres 2, 3 et 4 : présentent respectivement les trois types d'organisationsde fichiers UFAS-EXTENDED : séquentiel, relatif etséquentiel indexé.

Chapitre 5 : concerne les fichiers UFAS-EXTENDED disque et bandeet traite des points suivants : affectation au traitement,gestion des tampons et maintien de l'intégrité.

Chapitre 6 : est consacré à la conception, à la création et à lamodification des fichiers UFAS-EXTENDED sur disque.

Chapitre 7 : traite des fichiers UFAS-EXTENDED sur bande.

Chapitre 8 : décrit brièvement les utilitaires de gestion des fichiersUFAS-EXTENDED et des volumes.

Annexe A : fournit plusieurs méthodes de randomisation pour lesfichiers relatifs.

Annexe B : décrit les formats et labels standard des volumes bande.

Annexe C : donne des éléments permettant d'interpréter les vidages enhexadécimal des espaces adresses pour les fichiersséquentiels indexés.

Annexe D : contient les tableaux de correspondance GCL/JCL.

Annexe E : offre un complément d'informations sur les opérationsinternes effectuées sur les tampons.

Annexe F : traite du paramétrage des fichiers UFAS sous UFAS-EXTENDED (systèmes VBO uniquement).

Annexe G : décrit Batch Booster (optimiseur d'E/S Traitement par lots).

Préface

47 F2 04UF Rev04 v

BIBLIOGRAPHIE

Cette bibliographie est fournie à titre indicatif. Pour plus de précisions (disponibilité dumanuel, numéro de révision, indice de mise à jour), veuillez vous adresser à CEDOC ouéventuellement consulter le fascicule "Documents nouveaux" (référence 00 F4 7210).

Manuels de base :

COBOL 85 - Manuel de référence ................................................................... 47 F2 05ULCOBOL 85 Reference Manual .........................................................................47 A2 05UL

COBOL 85 - Guide de l'utilisateur .................................................................... 47 F2 06ULCOBOL 85 User's Guide..................................................................................47 A2 06UL

Utilitaires de gestion de données - Guide de l'utilisateur .................................47 F2 34UFData Management Utilities User's Guide .........................................................47 A2 34UF

GPL - Primitives système................................................................................. 47 F2 34ULGPL System Primitives ....................................................................................47 A2 34ULBatch Booster - Optimiseur d'E/S Traitement par lots .....................................47 F2 33UFBatch Booster...................................................................................................47 A2 33UF

IOF - Manuel de référence de l'utilisateur Vol. 1 : Introduction à IOF .............................................................................. 47 F2 38UJ Vol. 2 : Commandes système ........................................................................ 47 F2 39UJ Vol. 3 : Directives et commandes processeurs.............................................. 47 F2 40UJIOF Terminal User's Reference Manual Part 1 : Introduction to IOF............................................................................. 47 A2 38UJ Part 2 : System-level Commands................................................................... 47 A2 39UJ Part 3 : Directives and General Processors Commands ............................... 47 A2 40UJ

Migration des fichiers - Guide de l'utilisateur....................................................47 F2 32UFFile Migration Tool User's Guide ......................................................................47 A2 32UF

GCOS 7 Reconstitution des fichiers - Guide de l'utilisateur.............................47 F2 37UFGCOS 7 File Recovery Facilities User's Guide................................................47 A2 37UF

JCL - Manuel de référence............................................................................... 47 F2 11UJJCL Reference Manual .................................................................................... 47 A2 11UJ

JCL - Guide de l'utilisateur ............................................................................... 47 F2 12UJJCL User's Guide ............................................................................................. 47 A2 12UJ

GCL - Guide du programmeur ......................................................................... 47 F2 36UJGCL Programmer's Guide................................................................................ 47 A2 36UJ



Autres manuels cités :

Gestion des catalogues - Guide de l'utilisateur ................................................47 F2 35UFCatalog Management User's Guide .................................................................47 A2 35UF

GAC-EXTENDED - Guide de l'utilisateur .........................................................47 F2 12UFGAC-EXTENDED User's Guide.......................................................................47 A2 12UF

GCOS 7 - Manuel de l'administrateur du système...........................................47 F2 41USGCOS 7 System Administrator's Manual .........................................................47 A2 41US

IDS/II - Manuel de référence - Volume 1..........................................................47 F2 05UDIDS/II Reference Manual - Volume 1............................................................... 47 A2 05UD

IDS/II - Manuel de référence - Volume 2..........................................................47 F2 06UDIDS/II Reference Manual - Volume 2............................................................... 47 A2 06UD

IDS/II - Guide de l'utilisateur.............................................................................47 F2 07UDIDS/II User's Guide.......................................................................................... 47 A2 07UD

IDS/II - Manuel de référence ............................................................................47 F2 11UDIDS/II Reference Manual ................................................................................. 47 A2 11UD

IDS/II - Manuel de l'administrateur ...................................................................47 F2 13UDIDS/II Administrator's Manual.......................................................................... 47 A2 13UD

Messages et codes retour................................................................................ 47 F2 10UJMessages and Return Codes Directory ........................................................... 47 A2 10UJ

Tri et fusion - Guide de l'utilisateur...................................................................47 F2 08UFSORT/MERGE Utilities User's Guide...............................................................47 A2 08UF

TDS - Guide de l'administrateur .......................................................................47 F2 32UTTDS Administrator's Guide...............................................................................47 A2 32UT

TDS/COBOL - Manuel du programmeur..........................................................47 F2 33UTTDS/COBOL Programmer's Manual ................................................................47 A2 33UT

Dans ce manuel, les références sont citées sous forme abrégée (quatre dernierscaractères alphanumériques).

Préface

47 F2 04UF Rev04 vii

GCL ET JCL

La création, l'affectation, la manipulation et la maintenance des fichiersUFAS-EXTENDED peuvent s'effectuer au moyen du langage GCL (langage decommande GCOS 7) ou du langage JCL (langage de gestion des travaux). Dans cemanuel, toute commande GCL est suivie de son équivalent JCL entre parenthèses. Unetable de correspondance est fournie à l'annexe D.

CONVENTIONS D'ECRITURE

Les conventions d'écriture utilisées pour la syntaxe des commandes GCL sont lessuivantes :

ELEMENT Les majuscules indiquent un mot-clé, à introduire tel quel.

élément Les minuscules indiquent une valeur à fournir parl'utilisateur.

[élément] Les crochets indiquent un élément facultatif.

{élément1}

{élément2}

{élément3}

Une colonne d'éléments entre accolades indique que l'und'eux doit être sélectionné, si le paramètre correspondantest retenu. La valeur implicite (éventuelle) est soulignée(ici, élément2). A noter que le soulignement n'apparaît pasà l'écran.

47 F2 04UF Rev04 ix

Table des matières

1. Présentation .......................................................................................................... 1-1

1.1 PLAN DU CHAPITRE ................................................................................................. 1-1

1.2 GENERALITES ........................................................................................................... 1-2

1.3 CARACTERISTIQUES D'UFAS-EXTENDED ............................................................ 1-3

1.4 NOTIONS DE BASE ................................................................................................... 1-4

1.4.1 Articles ....................................................................................................................... 1-41.4.2 CI (intervalles de contrôle) ....................................................................................... 1-51.4.3 Espaces adresses ..................................................................................................... 1-71.4.4 Différents types de volumes disque ........................................................................ 1-81.4.4.1 Volumes FBO.............................................................................................................. 1-91.4.4.2 Volumes VBO.............................................................................................................. 1-10

2. Organisation séquentielle ............................................................................... 2-1

2.1 PLAN DU CHAPITRE ................................................................................................. 2-1

2.2 GENERALITES SUR L'ORGANISATION SEQUENTIELLE ...................................... 2-2

2.3 MODES D'OUVERTURE DES FICHIERS .................................................................. 2-3

2.4 MODE D'ACCES EN COBOL .................................................................................... 2-4

2.5 PREMIERE UTILISATION D'UN FICHIER SEQUENTIEL ......................................... 2-4


x 47 F2 04UF Rev04

2.6 FORMAT DES CI DE DONNÉES DANS UN FICHIER SÉQUENTIEL ...................... 2-5

3. Organisation relative ......................................................................................... 3-1

3.1 PLAN DU CHAPITRE ................................................................................................. 3-1

3.2 GENERALITES SUR L'ORGANISATION RELATIVE ............................................... 3-2


3.4 MODES D'ACCES EN COBOL .................................................................................. 3-3

3.4.1 Mode d'accès séquentiel .......................................................................................... 3-43.4.2 Mode d'accès direct .................................................................................................. 3-53.4.3 Mode d'accès dynamique ......................................................................................... 3-6

3.5 PREMIERE UTILISATION D'UN FICHIER RELATIF ................................................. 3-6

3.6 FORMAT DES CI DE DONNEES DANS UN FICHIER RELATIF .............................. 3-7

3.7 EXEMPLE D'APPLICATION ...................................................................................... 3-9

4. Organisation séquentielle indexée .............................................................. 4-1

4.1 PLAN DU CHAPITRE ................................................................................................. 4-1

4.2 GENERALITES SUR L'ORGANISATION SEQUENTIELLE INDEXEE ..................... 4-2


4.4 MODES D'ACCES EN COBOL-85 ............................................................................. 4-6

4.4.1 Mode d'accès séquentiel en COBOL-85 ................................................................. 4-64.4.2 Mode d'accès direct .................................................................................................. 4-84.4.3 Mode d'accès dynamique ......................................................................................... 4-9

4.5 PREMIERE UTILISATION D'UN FICHIER SEQUENTIEL INDEXE .......................... 4-10

4.6 ADJONCTION D'ARTICLES ...................................................................................... 4-10

Table des matières

47 F2 04UF Rev04 xi

4.7 SUPPRESSION D'ARTICLES .................................................................................... 4-10

4.8 CLES SECONDAIRES ............................................................................................... 4-11

4.8.1 Création des index secondaires .............................................................................. 4-114.8.2 Mise à jour des index secondaires .......................................................................... 4-12

4.9 STRUCTURE D'UN FICHIER SEQUENTIEL INDEXE UFAS-EXTENDED ............... 4-13

4.9.1 Espace adresses 1 .................................................................................................... 4-134.9.2 Espace adresses 2 .................................................................................................... 4-134.9.3 Espace adresses 3 .................................................................................................... 4-134.9.4 Espace adresses 4 .................................................................................................... 4-134.9.5 Espace adresses 5 .................................................................................................... 4-144.9.6 Espace adresses 6 .................................................................................................... 4-144.9.7 Espace adresses 7 .................................................................................................... 4-154.9.8 Recherche dans l'index primaire ............................................................................. 4-164.9.9 Recherche dans un index secondaire ..................................................................... 4-164.9.10 Structure de l'index primaire et secondaire ........................................................... 4-18

4.10 ESPACE LIBRE DANS LES CI .................................................................................. 4-19

4.11 INSERTION D'ARTICLES .......................................................................................... 4-20

4.11.1 Insertion sans réorganisation de CI ........................................................................ 4-204.11.2 Insertion avec compactage du CI ............................................................................ 4-214.11.3 Insertion avec réorganisation incrémentale de CI ................................................. 4-224.11.4 Insertion avec réorganisation de CI d'index ........................................................... 4-23

4.12 FORMAT DES CI DE DONNEES DANS UN FICHIER SEQUENTIEL INDEXÉ ........ 4-25

4.13 EXEMPLE D'APPLICATION ...................................................................................... 4-27

5. Fichiers disque et bande - Affectation, gestion des tampons etintégrité ................................................................................................................... 5-1

5.1 PLAN DU CHAPITRE ................................................................................................. 5-1

5.2 PARAMETRAGE DES FICHIERS EN GCL ................................................................ 5-3

5.3 PARAMETRAGE DES FICHIERS EN JCL ................................................................ 5-4

5.4 PARAMETRAGE DES FICHIERS DANS LES PROGRAMMES UTILISATEUR ....... 5-5


xii 47 F2 04UF Rev04

5.5 GROUPE DE PARAMETRES ASGN (AFFECTATION DE FICHIERS) ..................... 5-6

5.6 TYPES DE VOLUMES................................................................................................ 5-9

5.6.1 Volumes résidants .................................................................................................... 5-95.6.2 Volumes de manoeuvre ............................................................................................ 5-105.6.3 Volumes nommément désignés .............................................................................. 5-11

5.7 FICHIERS MULTIVOLUMES ..................................................................................... 5-12

5.7.1 Traitement partiel et extension du nombre de volumes ....................................... 5-135.7.2 Gestion du nombre d'appareils mobilisés (paramètre MOUNT) .......................... 5-14

5.8 POOLS D'APPAREILS (PARAMETRES POOL) ....................................................... 5-16

5.9 PARTAGE DE FICHIER (PARAMETRE SHARE) ...................................................... 5-18

5.10 REGLES DE RECOUVREMENT DES VALEURS DE PARAMETRES ..................... 5-21

5.11 GROUPE DE PARAMETRES DEFN (DEFINITION DE FICHIERS) .......................... 5-23

5.12 GESTION DES TAMPONS ......................................................................................... 5-24

5.12.1 Paramètre POOLSIZE ................................................................................................ 5-265.12.2 Paramètre BUFPOOL ................................................................................................ 5-285.12.3 Clause RESERVE AREAS/Paramètre NBBUF ......................................................... 5-315.12.4 Exemples d'utilisation des tampons ....................................................................... 5-335.12.5 Optimisation des paramètres de gestion des tampons ........................................ 5-405.12.6 Statistiques UFAS-EXTENDED figurant dans le JOR ............................................ 5-42

5.13 JOURNALISATION .................................................................................................... 5-46

5.13.1 Journal Avant (BEFORE) .......................................................................................... 5-465.13.2 Journal Après (AFTER) ............................................................................................. 5-47

5.14 INTEGRITE DES FICHIERS ....................................................................................... 5-48

5.14.1 Phase de création ...................................................................................................... 5-485.14.1.1 Fichiers sans clés secondaires ................................................................................... 5-495.14.1.2 Fichiers avec clés secondaires ................................................................................... 5-49

5.14.2 Phase de traitement .................................................................................................. 5-495.14.2.1 Fichiers ouverts en entrée (INPUT) ............................................................................ 5-495.14.2.2 Fichiers ouverts en entrée-sortie (I-O) ........................................................................ 5-505.14.2.3 Fichiers sans clés secondaires ................................................................................... 5-505.14.2.4 Fichiers avec clés secondaires ................................................................................... 5-51

5.14.3 Phase d'extension ..................................................................................................... 5-52

Table des matières

47 F2 04UF Rev04 xiii

5.14.4 Erreurs d'E/S persistantes ....................................................................................... 5-52

6. Fichiers disque - Création et modification ............................................... 6-1

6.1 PLAN DU CHAPITRE ................................................................................................. 6-1

6.2 GENERALITES ........................................................................................................... 6-2

6.3 RESERVATION D'ESPACE ....................................................................................... 6-3

6.3.1 Taille de CI (paramètre CISIZE) ................................................................................ 6-56.3.2 Tailles de CI recommandées pour les fichiers sur disques non-FSA .................. 6-66.3.3 Capacités de stockage par type de disques ........................................................... 6-76.3.4 Taille initiale du fichier (paramètre SIZE ou SPLIT) ............................................... 6-116.3.5 Taille d'incrément (paramètre INCRSIZE) ............................................................... 6-12

6.4 SIMULATION D'AFFECTATION DE PLACE À UN FICHIER .................................... 6-13

6.5 CALCULS D'ESPACE POUR UN FICHIER SEQUENTIEL ....................................... 6-14

6.5.1 Articles de longueur fixe .......................................................................................... 6-146.5.2 Articles de longueur variable ................................................................................... 6-17

6.6 CALCULS D'ESPACE POUR UN FICHIER RELATIF ............................................... 6-19

6.7 PARAMETRAGE DES FICHIERS SEQUENTIELS INDEXES ................................... 6-22

6.7.1 Taille de CI (paramètre CISIZE) pour un fichier séquentiel indexé ...................... 6-236.7.2 Espace libre par CI (paramètre CIFSP) ................................................................... 6-246.7.3 Insertion de masse .................................................................................................... 6-256.7.4 Fichiers avec clés secondaires ............................................................................... 6-256.7.5 Calculs d'espace ....................................................................................................... 6-266.7.5.1 Fichiers sans index secondaires ................................................................................. 6-266.7.5.2 Fichiers avec index secondaires ................................................................................. 6-31

6.8 GCL DE CREATION, DE LISTAGE ET DE MODIFICATION .................................... 6-39

6.8.1 Commande BUILD_FILE ........................................................................................... 6-396.8.1.1 Exemples de création par la commande BUILD_FILE ............................................... 6-41

6.8.2 Commande CREATE_FILE ....................................................................................... 6-446.8.3 Groupe de paramètres ALCn ................................................................................... 6-476.8.4 Groupe de paramètres DEFn ................................................................................... 6-496.8.5 Commande LIST_FILE .............................................................................................. 6-526.8.6 Commande LIST_FILE_SPACE ................................................................................ 6-536.8.7 Commande MODIFY_FILE ........................................................................................ 6-546.8.8 Commande MODIFY_FILE_SPACE ......................................................................... 6-56


xiv 47 F2 04UF Rev04

7. Fichiers bande (classique ou en cartouche) - Format standard,types, labels et création ................................................................................... 7-1

7.1 PLAN DU CHAPITRE ................................................................................................. 7-1

7.2 TYPES DE FICHIERS BANDE ................................................................................... 7-2

7.3 LABELS ...................................................................................................................... 7-3

7.4 LES ATTRIBUTS DE FICHIER .................................................................................. 7-4

7.4.1 Longueur d'article (paramètre RECSIZE) ................................................................ 7-47.4.2 Longueur de bloc (paramètre BLKSIZE) ................................................................. 7-47.4.3 Format d'article (paramètre RECFORM) ................................................................. 7-47.4.3.1 Articles de longueur fixe.............................................................................................. 7-57.4.3.2 Articles de longueur variable ....................................................................................... 7-6

7.5 CHOIX DE LA LONGUEUR DE BLOC ...................................................................... 7-9

7.6 CREATION DES FICHIERS BANDE (CLASSIQUE OU EN CARTOUCHE) ............. 7-10

7.7 PARAMETRAGE DES FICHIERS BANDE DANS EXEC_PG ................................... 7-13

7.8 LONGUEUR MINIMALE DE BLOC ............................................................................ 7-15

7.9 DONNÉES COMPRESSÉES SUR BANDE ............................................................... 7-15

8. Fichiers disque et bande - Manipulation et maintenance .................. 8-1

8.1 PLAN DU CHAPITRE ................................................................................................. 8-1

8.2 TRI ET FUSION (SORT_FILE ET MERGE_FILE) ..................................................... 8-2

8.3 CHARGEMENT (LOAD_FILE) ................................................................................... 8-3

8.3.1 Passage du format UFAS au format UFAS-EXTENDED ........................................ 8-58.3.2 Passage du format VBO au format FBO ................................................................. 8-6

8.4 MANIPULATION DES DONNEES : LE LANGAGE DSL ........................................... 8-7

Table des matières

47 F2 04UF Rev04 xv

8.5 UTILITAIRES DE GESTION DE FICHIERS ............................................................... 8-8

8.6 UTILITAIRES DE GESTION DE VOLUMES .............................................................. 8-11

8.7 VISIBILITÉ DE L'ESPACE PHYSIQUE ET LOGIQUEAFFECTÉ AUX FICHIERS DISQUE UFAS ................................................................ 8-12


xvi 47 F2 04UF Rev04

Annexes

A. Fichiers relatifs - Randomisation ................................................................. A-1

A.1 TECHNIQUES DE RANDOMISATION ....................................................................... A-1

A.2 DIVISION PAR UN NOMBRE PREMIER ................................................................... A-2

A.3 ELEVATION AU CARRE, PLIAGE ET EXTRACTION ............................................... A-4

A.4 CHANGEMENT DE BASE DE NUMERATION .......................................................... A-5

A.5 ANALYSE DES FREQUENCES ................................................................................. A-6

A.5.1 Transformation clé-adresse relative ....................................................................... A-8

A.6 CLES NON NUMERIQUES ........................................................................................ A-11

B. Volumes bande - Formats et labels standard ......................................... B-1

B.1 GENERALITES ........................................................................................................... B-1

B.1.1 Relation volume (bobine)/fichier ............................................................................. B-2B.1.2 Organisation des fichiers ......................................................................................... B-2B.1.3 Organisation des données ....................................................................................... B-3

B.2 FORMATS ET LABELS STANDARD ......................................................................... B-4

B.2.1 Généralités ................................................................................................................. B-4B.2.2 Format standard GCOS 7/ASCII ............................................................................... B-16

C. Fichiers séquentiels indexés - Représentation hexadécimaledes espaces adresses ...................................................................................... C-1

Table des matières

47 F2 04UF Rev04 xvii

D. Correspondance GCL/JCL .............................................................................. D-1

E. Opérations internes sur les tampons ......................................................... E-1

F. Paramétrage des fichiers UFAS sous UFAS-EXTENDED .................. F-1

G. Batch Booster (Optimiseur d'E/S Traitement par lots) ....................... G-1

G.1 PRÉSENTATION ........................................................................................................ G-1

G.1.1 Mise en oeuvre de Batch Booster ........................................................................... G-1G.1.1.1 Lancement externe au programme............................................................................. G-1G.1.1.2 Lancement au sein d'un programme........................................................................... G-2

G.1.2 Mode d'exécution du traitement BPB ..................................................................... G-2

G.2 CONDITIONS D'EXÉCUTION DU TRAITEMENT BPB ............................................. G-2

G.3 BPB ET UTILITAIRES DE GESTION DE DONNÉES ................................................ G-3

G.3.1 Transfert de fichiers .................................................................................................. G-3G.3.2 Utilitaires de Tri/Fusion (SORT/MERGE) ................................................................ G-4G.3.2.1 Tri ................................................................................................................................ G-4G.3.2.2 Fusion.......................................................................................................................... G-5

G.4 BPB EN ENVIRONNEMENT GCL ............................................................................. G-6

Index ................................................................................................................................... i-1


xviii 47 F2 04UF Rev04

Illustrations

Figures

1-1 L'article : unité d'échange entre UFAS-EXTENDED et les programmes .................... 1-41-2 Unité de transfert entre UFAS-EXTENDED et le disque............................................. 1-61-3 Structure logique des fichiers disque séquentiels et relatifs ....................................... 1-71-4 Structure logique des fichiers disque séquentiels indexés.......................................... 1-71-5 Implantation d'un CI dans des blocs de données........................................................ 1-91-6 Piste de disque............................................................................................................ 1-101-7 Structure physique d'un volume VBO et système d'adressage .................................. 1-111-8 Fichiers, volumes et fragments ................................................................................... 1-121-9 Structure physique d'un fichier disque ........................................................................ 1-121-10 Relation entre structure physique et structure logique d'un fichier disque .................. 1-132-1 Structure logique d'un fichier séquentiel ..................................................................... 2-22-2 Relation entre mode d'ouverture et mode d'accès pour un fichier séquentiel ............ 2-32-3 Format des CI de données dans un fichier séquentiel

(articles de longueur fixe)............................................................................................ 2-62-4 Format des CI de données dans un fichier séquentiel

(articles de longueur variable) ..................................................................................... 2-63-1 Structure logique d'un fichier relatif ............................................................................. 3-23-2 Accès séquentiel à un fichier relatif en COBOL.......................................................... 3-43-3 Accès direct à un fichier relatif en COBOL.................................................................. 3-53-4 Accès dynamique à un fichier relatif en COBOL......................................................... 3-63-5 Format des CI de données dans un fichier relatif

(articles de longueur fixe)............................................................................................ 3-73-6 Format des CI de données dans un fichier relatif

(articles de longueur variable) ..................................................................................... 3-73-7 Exemple d'application utilisant un fichier relatif........................................................... 3-94-1 Exemple de clés dans un article de fichier séquentiel indexé..................................... 4-24-2 Accès séquentiel à un fichier séquentiel indexé en COBOL....................................... 4-74-3 Accès direct à un fichier séquentiel indexé en COBOL .............................................. 4-84-4 Accès dynamique à un fichier séquentiel indexé en COBOL...................................... 4-94-5 Structure logique d'un fichier séquentiel indexé.......................................................... 4-154-6 Structure de l'index primaire dans un fichier séquentiel

indexé sans clés secondaires ..................................................................................... 4-174-7 Structure des index secondaires dans un fichier séquentiel

indexé avec clés secondaires ..................................................................................... 4-184-8 Espace libre dans un fichier séquentiel indexé ........................................................... 4-194-9 Insertion sans réorganisation de CI ............................................................................ 4-204-10 Insertion avec compactage du CI................................................................................ 4-214-11 Insertion avec réorganisation incrémentale de CI....................................................... 4-224-12 Insertion avec réorganisation de CI d'index ................................................................ 4-244-13 Format des CI de données dans un fichier séquentiel indexé

(articles de longueur fixe ou variable) ......................................................................... 4-255-1 Affectation de fichiers à un programme ...................................................................... 5-65-2 Affectation de fichiers dans la commande EXEC_PG (1/2)........................................ 5-75-2 Affectation de fichiers dans la commande EXEC_PG (2/2)........................................ 5-85-3 Utilisation de volumes résidants.................................................................................. 5-95-4 Utilisation de volumes de manoeuvre ......................................................................... 5-105-5 Utilisation de volumes nommément désignés............................................................. 5-11

Table des matières

47 F2 04UF Rev04 xix

5-6 Utilisation d'un fichier disque ou bande multivolume non catalogué........................... 5-125-7 Utilisation d'un fichier multivolume catalogué.............................................................. 5-125-8 Traitement partiel/extension de fichiers bande multivolumes ..................................... 5-135-9 Gestion des périphériques pour le traitement des fichiers multivolumes.................... 5-155-10 Mise en oeuvre d'un pool d'appareils .......................................................................... 5-165-11 Partage d'un fichier par deux activités ........................................................................ 5-185-12 Combinaisons SHARE/ACCESS ................................................................................ 5-195-13 Règles de partage d'un fichier..................................................................................... 5-205-14 Structure de la mémoire tampon................................................................................. 5-255-15 Possibilités d'utilisation du journal Avant..................................................................... 5-465-16 Possibilités d'utilisation du journal Après .................................................................... 5-476-1 Exemple d'utilisation de CIFSP ................................................................................... 6-247-1 Types de fichiers bande .............................................................................................. 7-27-2 Exemples d'articles de formats F et FB ...................................................................... 7-57-3 Exemple d'articles de format V ................................................................................... 7-67-4 Enregistrement des articles de format V..................................................................... 7-77-5 Enregistrement des articles de format VB .................................................................. 7-8B-1 Formats reconnus conformes à GCOS 7/EBCDIC..................................................... B-13B-1 Formats reconnus conformes à GCOS 7/EBCDIC (2/2) ............................................ B-14B-2 Formats créés par GCOS 7 ........................................................................................ B-15B-3 Formats reconnus conformes à GCOS 7/ASCII ......................................................... B-21E-1 Opérations internes sur les tampons .......................................................................... E-3

Tableaux

6-1 Valeurs recommandées pour CISIZE ......................................................................... 6-66-2 Capacité des volumes sur disques FSA ..................................................................... 6-76-3 Capacité des volumes sur disques non-FSA .............................................................. 6-86-4 Capacité respective des volumes VBO et FBO sur disques MS/D500....................... 6-96-5 Capacité respective des volumes VBO et FBO sur disques MS/B10 ......................... 6-108-1 Utilitaires de niveau de fichier (1/3) ............................................................................. 8-88-1 Utilitaires de niveau de fichier (2/3) ............................................................................. 8-98-1 Utilitaires de niveau de fichier (3/3) ............................................................................. 8-108-2 Utilitaires de niveau volume ........................................................................................ 8-11A-1 Nombres premiers....................................................................................................... A-2A-2 Table des fréquences.................................................................................................. A-7A-3 Développement d'une adresse relative ....................................................................... A-8A-4 Table des clés ............................................................................................................. A-9B-1 Types de labels ........................................................................................................... B-4B-2 Label début de volume VOL1 (GCOS 7/EBCDIC) ...................................................... B-6B-3 Label début de fichier HDR1 (GCOS 7/EBCDIC) (1/2) ............................................... B-7B-3 Label début de fichier HDR1 (GCOS 7/EBCDIC) (2/2) ............................................... B-8B-4 Label début de fichier HDR2 (GCOS 7/EBCDIC) (1/2) ............................................... B-9B-4 Label début de fichier HDR2 (GCOS 7/EBCDIC) (2/2) ............................................... B-10B-5 Label fin de fichier EOF1 (GCOS 7/EBCDIC) ............................................................. B-11B-6 Label fin de volume EOV1 (GCOS 7/EBCDIC)........................................................... B-12B-7 Label début de volume VOL1 (GCOS 7/ASCII) .......................................................... B-16B-8 Label début de fichier HDR1 (GCOS 7/ASCII) (1/2) ................................................... B-17B-8 Label début de fichier HDR1 (GCOS 7/ASCII) (2/2) ................................................... B-18B-9 Label début de fichier HDR2 (GCOS 7/ASCII)............................................................ B-19B-10 Label fin de fichier EOF1 (GCOS 7/ASCII) ................................................................. B-20D-1 Correspondances JCL/GCL (1/2)................................................................................ D-1D-2 Correspondances JCL/GCL (2/2)................................................................................ D-2D-3 Correspondances GCL/JCL (1/2)................................................................................ D-3D-4 Correspondances GCL/JCL (2/2)................................................................................ D-4


xx 47 F2 04UF Rev04

47 F2 04UF Rev04 1-1

1. Présentation

1.1 PLAN DU CHAPITRE

• Généralités.

• Caractéristiques d'UFAS-EXTENDED.

• Notions de base :

- Articles (longueur fixe et longueur variable).- CI (intervalle de contrôle).- Espaces adresses.- Blocs de fichier.

• Caractéristiques des disques :

- Disques FSA.- Disques non-FSA.- Adresse.- Fragment (extent).

• Structure physique et structure logique d'un fichier disque.


1-2 47 F2 04UF Rev04

1.2 GENERALITES

UFAS-EXTENDED est le système standard d'accès aux fichiers pour toutes lesapplications exploitables sur DPS 7000 sous GCOS 7 à compter de la version V5.

Il constitue l'interface entre la gestion logique des données et la mémoire externe. Il secompose d'un ensemble de routines de création, de lecture et de mise à jour des fichierssur disque et sur bande (classique ou en cartouche).

UFAS-EXTENDED assure les fonctions suivantes, indépendamment des caractéristiquesphysiques des supports :

• gestion des tampons,• regroupement des données en blocs,• contrôle des erreurs,• placement et recherche des articles,• traitement des labels.

Tous les CI d'un fichier UFAS-EXTENDED ont la même longueur (voir plus loin dans cechapitre).

UFAS-EXTENDED gère un grand nombre de tampons, ce qui a pour effet de minimiserles opérations d'E/S :

• jusqu'à 20.000 tampons par application TDS (18.500 pour les fichiers avec l'attributPREVIOUS) ;

• jusqu'à 32.000 tampons au niveau système (pour plusieurs applications, y compristraitement par lots).

De plus, il autorise un grand nombre de fichiers :

• environ 500 ouvertures simultanées de fichiers par application TDS ;

• environ 1000 fichiers partageables au niveau système (par plusieurs applications TDS)pour un niveau de partage égal à 5, ou 3200 fichiers pour un niveau de partage égalà 2.

Présentation

47 F2 04UF Rev04 1-3

1.3 CARACTERISTIQUES D'UFAS-EXTENDED

1. UFAS-EXTENDED admet les organisations de fichiers suivantes :

- séquentielle,- relative,- séquentielle indexée,- IDS/II (base de données).

Remarques :

1. L'organisation détermine un mode de rangement des articlesadapté aux besoins du traitement prévu pour le fichier.

2. Un fichier IDS/II est un fichier base de données contenant plusieurstypes d'articles et leurs relations logiques. Physiquement, le fichierIDS/II est un ensemble d'aires. Pour plus de précisions, se reporterau manuel de référence IDS/II correspondant.

2. Les fichiers, quelle que soit leur organisation, sont exploitables dans les troisdimensions de GCOS 7 :

- traitement par lots (BATCH),- transactionnel (TDS),- interactif (IOF).

3. Avec les fichiers UFAS-EXTENDED, il est possible d'utiliser tous les modes et lesverbes d'accès du COBOL 85 aux normes ANSI.

4. Autres caractéristiques :

- fichiers multivolumes (fichiers s'étendant sur plusieurs volumes) et volumes multifichiers (volumes contenant plusieurs fichiers), sur disque et sur bande (classique ou en cartouche) ;

- traitement des labels disque et bande (classique ou en cartouche) standard ;

- traitement standard des erreurs tel que défini pour le COBOL 85 ;

- maintien de l'intégrité des fichiers grâce aux mécanismes de journalisation et de relance sur point de reprise ;

- accès concurrents aux fichiers par plusieurs programmes ;

- extension statique et dynamique des fichiers séquentiels et séquentiels indexés.


1-4 47 F2 04UF Rev04

1.4 NOTIONS DE BASE

Les principaux éléments nécessaires à la compréhension d'UFAS-EXTENDED sont lessuivants :

• articles,• CI (intervalles de contrôle),• espaces adresses,• caractéristiques physiques des disques.

Les trois premiers points concernent exclusivement les fichiers disque.

En outre, il convient de définir les deux concepts suivants pour les volumes FBO :

• Bloc de données : plus petite unité adressable par une E/S dans un volume FBO. Sataille est de 512 octets sur un disque FSA et de 4096 octets dans un volume FBOimplanté sur un disque non-FSA.

• Bloc de fichier : plus petite unité accessible au système d'accès. Cette notioncorrespond à celle de CI dans le cas des fichiers UFAS. Un bloc de fichier peut êtreconstitué de 1 à n blocs de données.

A noter que les informations spécifiques des fichiers bande (classique ou en cartouche)sont regroupées au chapitre 7.

1.4.1 Articles

L'article est l'unité d'échange de données entre UFAS-EXTENDED et les programmesutilisateur. Les articles sont définis dans les programmes et permettent la manipulationdes données. Un fichier est un ensemble d'articles doté d'un nom.

Les articles peuvent être de longueur fixe ou variable :

UFAS-EXTENDED

GCOS 7

Program m esutilisa teur

U tilita iressystèm e

A rticles

Figure 1-1. L'article : unité d'échange entre UFAS-EXTENDED et les programmes

Présentation

47 F2 04UF Rev04 1-5

Longueur fixe et longueur variable

La longueur des articles peut être fixe ou variable (l'utilisateur précise son choix à lacréation du fichier, au moment où il en déclare les attributs au système).

Exemple d'utilisation d'articles de longueur fixe

Soit un fichier Paye, avec, pour chaque employé, un article de la forme suivante :

NO M

EM PLO YEADR ESSE

N °SEC URITESO C IALE

N°

M ATRIC ULE

CO D E

R ETENU ES

Tous les articles contiennent la même quantité d'informations ; ils sont donc tous de lamême longueur.

Exemple d'utilisation d'articles de longueur variable

Soit un fichier Commandes, avec, pour chaque client, un article par année.

En théorie, chaque client peut passer une commande par semaine, mais, dans lapratique, le nombre de commandes par client ne dépasse jamais 20 par an.

L'article se présente sous la forme suivante :

N ° C LIEN TDISTRICT

DEVEN TE

ANN EECO M M AN DE

N ° 1

C O M M AN DE

N ° 2

C O M M AN DE

N° 20

Supposons que le nombre moyen de commandes par client soit annuellement de cinq. Siles articles étaient de longueur fixe (avec 20 zones commande par article), seul 25 % del'espace réservé aux commandes serait occupé dans le fichier. Pour éviter cette perte deplace importante, il est donc préférable de travailler avec des articles de longueurvariable, qui ont l'avantage de n'occuper que l'espace nécessaire aux données (plusl'espace indispensable aux informations de gestion UFAS-EXTENDED).

Dans le cadre d'UFAS-EXTENDED, toutes les organisations de fichier admettent lesarticles de longueur variable.Lorsque l'utilisateur souhaite travailler avec des articles de longueur variable, il doitdéclarer la longueur maximale d'article au moment où il réserve de l'espace sur le supportpour le fichier.

1.4.2 CI (intervalles de contrôle)

Ce paragraphe concerne exclusivement les fichiers disque. Les informations spécifiquesdes fichiers bande sont regroupées au chapitre 7.


1-6 47 F2 04UF Rev04

L'unité de transfert des données entre UFAS-EXTENDED et le disque est l'intervalle decontrôle ou CI (Control Interval). Suivant la taille déclarée par l'utilisateur, chaque CI peutcontenir un ou plusieurs articles (2 articles minimum pour un fichier séquentiel indexé).Les CI UFAS-EXTENDED correspondent aux pages IDS/II. Les principalescaractéristiques des CI UFAS-EXTENDED sont les suivantes :

• Tous les types de CI (CI de données, CI d'index et CI de gestion) ont la même taille.

• Chaque CI de données contient un nombre entier d'articles, pouvant aller jusqu'à 255.Un article ne peut être réparti sur deux CI.

• La taille de CI ne peut être inférieure à la longueur d'article (longueur maximale d'articlepour le format variable).

• La taille maximale de CI est de 32.256 octets (32 Ko - 512).

• Fichiers FBO : la taille de CI doit correspondre à un nombre entier de blocs de données(voir plus loin dans ce chapitre).

Fichiers VBO : la taille de CI ne peut excéder une piste, et un CI ne peut pas êtreréparti sur deux pistes.

• La taille de CI est toujours un multiple de 512 octets. L'utilisateur peut spécifiern'importe quelle valeur dans la limite de cinq chiffres : UFAS-EXTENDED l'arrondit sinécessaire au multiple de 512 immédiatement supérieur. La taille optimale de CI pourchaque type d'unité de disques non-FSA est donnée au chapitre 6 (tableau 6-1).

• Le nombre maximal de CI dans un fichier est limité à 16.777.215 (2 puissance 24moins 1).

Pour plus de détails sur les CI, consulter les chapitres relatifs aux différentesorganisations de fichiers.

UFAS-EXTENDED

GCOS 7

P rogram m esutilisa teur

U tilita iressystèm e

Interva llede contrô le

(C I)

A rtic les

Figure 1-2. Unité de transfert entre UFAS-EXTENDED et le disque

Présentation

47 F2 04UF Rev04 1-7

1.4.3 Espaces adresses

Ce paragraphe concerne exclusivement les fichiers disque. Les informations spécifiquesdes fichiers bande sont regroupées au chapitre 7.

D'un point de vue logique, un fichier disque est structuré en espaces adresses ; chaqueespace adresses regroupe des données de la même catégorie (informations de gestion,données utilisateur, index).

Les figures 1-3 et 1-4 montrent la répartition des différents types de CI suivantl'organisation de fichier.

Fichiers séquentiels et relatifs

Espace adresses 2

C Id e

do nn ée s

C Id e

do nn ée s

C Id e

do nn ée s

C Id e

do nn ée s

C Ide

données

C Id e

do nn ée s

E spacead resses 1

C Ide

données

Figure 1-3. Structure logique des fichiers disque séquentiels et relatifs

• L'espace adresses 1 contient des informations de gestion telles que la description desautres espaces adresses et, éventuellement, les labels utilisateur. Ces informationssont utilisées et gérées par UFAS-EXTENDED. Elles commencent toujours au débutde la première piste de l'espace affecté au fichier. La longueur de l'espace adresses 1est toujours égale à une piste (VBO), ou à un minimum de 16 Koctets (FBO).

• L'espace adresses 2 contient les CI de données.

Fichiers séquentiels indexés

C I de don né es C I d 'index seconda ire

E spacead resses 1

E spaceadresses 3

E spaceadresses 4

E spacead resses 2

E spacead resses 7

E spaceadresses 5

E spaceadresses 6

C I d 'index prim a ire

Figure 1-4. Structure logique des fichiers disque séquentiels indexés

• L'espace adresses 1 contient des informations de gestion telles que la description desautres espaces adresses et, éventuellement, les labels utilisateur. Ces informationssont utilisées et gérées par UFAS-EXTENDED. L'espace adresses 1 occupe toujoursune piste (VBO), ou les 16 premiers Koctets du fichier (FBO).

• L'espace adresses 2 contient les CI de données.


1-8 47 F2 04UF Rev04

• Les espaces adresses 3 et 4 contiennent les CI d'index primaire. Les espacesadresses 5, 6 et 7 contiennent les CI d'index secondaire.

Les notions d'index primaire et d'index secondaire sont définies au chapitre 4.

Avant d'étudier la relation existant entre la structure logique et la structure physique desfichiers, il convient d'analyser brièvement les caractéristiques des disques.

1.4.4 Différents types de volumes disque

Un volume disque est constitué d'une pile de disques superposés, montés sur un axecommun. Les deux faces externes de la pile servent de protection. Toutes les autresfaces de disque sont utilisées pour l'enregistrement.

A noter que la notion de volume disque physique est à distinguer de celle de volumelogique, qui détermine la manière dont s'effectue la réservation de place pour les fichiers.On distingue deux organisations de volumes :

• les volumes FBO (Fixed Block Organization : organisation à blocs de longueur fixe,apparue sous GCOS 7-V5) ;

• les volumes VBO (Variable Block Organization : organisation à blocs de longueurvariable, déjà utilisée dans les versions antérieures de GCOS).

En matière d'architecture physique, on distingue :

• les disques FSA (Fixed Sector Architecture), qui n'acceptent que l'organisation FBO(classe d'appareils : MS/FSA) ;

• les disques non-FSA ou CKD (classes d'appareils MS/D500 et MS/B10), qui peuventêtre formatés VBO ou FBO (au moyen de l'utilitaire VOLPREP).

Présentation

47 F2 04UF Rev04 1-9

1.4.4.1 Volumes FBO

Les volumes FBO peuvent être implantés soit sur des disques FSA (MS/FSA), soit surdes disques non-FSA au format FBO (MS/B10 ou MS/D55). Ces volumes sont organisésen blocs de données de longueur fixe.

Les blocs de données ont une longueur de 512 octets sur les disques FSA, et de4096 octets sur les disques non-FSA formatés FBO. Les CI (blocs de fichier) des fichiersFBO ont une longueur multiple de 512.

Physiquement, les CI sont implantés dans les blocs de données de manière à optimiserl'occupation du volume. Un CI occupe toujours un nombre entier de blocs de données.

CI

Figure 1-5. Implantation d'un CI dans des blocs de données

Le CI représenté à la figure 1-5 occupe 7 blocs de données, soit 3584 octets (512 x 7).


1-10 47 F2 04UF Rev04

1.4.4.2 Volumes VBO

Les volumes VBO sont organisés en cylindres et en pistes. Ils sont implantés sur desdisques non-FSA au format VBO (MS/B10 ou MS/D500).

Piste

Chaque face d'enregistrement est divisée en un certain nombre de bandes concentriquesappelées pistes, sur lesquelles sont enregistrées les données. Une piste est la surfacebalayée par une tête de lecture/écriture pendant une rotation du disque. La figure 1-6présente une piste.

Tê te d elec tu re -é c ritu re

F aced 'enreg istrem en t

P is te

A xe

Figure 1-6. Piste de disque

Cylindre

L'ensemble des pistes situées au même endroit sur chaque face d'enregistrement, doncse trouvant sous les têtes de lecture/écriture pour une position donnée du mécanismed'accès, constitue un cylindre logique. Par exemple, les pistes situées le plus à l'extérieur(une par face d'enregistrement) forment un cylindre (voir figure 1-7).

Présentation

47 F2 04UF Rev04 1-11

Adresse

Un emplacement dans un volume disque est désigné par une adresse exprimée sous laforme :

• d'un numéro de bloc (de données) pour les volumes FBO,

• d'un numéro de cylindre et d'un numéro de piste pour les volumes VBO.

Les cylindres sont numérotés séquentiellement de l'extérieur (cylindre 000) vers l'intérieur.

Les pistes sont numérotées en fonction de la face d'enregistrement sur laquelle elles setrouvent. Toutes les pistes de la première face d'enregistrement (c'est-à-dire la faceinférieure du premier disque depuis le haut de la pile) portent le numéro 00 ; toutes lespistes de la deuxième face d'enregistrement (face supérieure du second disque) ont lenuméro 01, et ainsi de suite jusqu'à la dernière face utile.

C Y L IN D R E 70 7C Y L IN D R E 00 0

D IS Q U E S

P IS TE 00P IS TE 01





Figure 1-7. Structure physique d'un volume VBO et système d'adressage

Fragment (extent)

Un fichier disque peut occuper un ou plusieurs fragments (extents). On appelle "fragment"un ensemble de pistes contiguës (VBO) ou de blocs de données contigus (FBO)appartenant au même volume disque.


1-12 47 F2 04UF Rev04

La figure 1-8 illustre la relation entre volumes disque, fichiers et fragments, avec :

• un fichier A monovolume monofragment,• un fichier B monovolume multifragment,• un fichier C multivolume multifragment.

A C B C B C

Figure 1-8. Fichiers, volumes et fragments

Relation entre structure physique et structure logique d'un fichier

La figure 1-9 représente un fichier occupant quatre fragments. Les fragments 1 et 2appartiennent au volume X, et les fragments 3 et 4 au volume Y.

V o lu m e X

V o lu m e Y

F ragm en t1

F ragm en t2

F ragm en t3

F ragm en t4

Figure 1-9. Structure physique d'un fichier disque

Présentation

47 F2 04UF Rev04 1-13

La figure 1-10 indique la relation entre fragments (physiques) et espaces adresses(logiques).

F ragm en t 4F ragm en t 1 F ragm en t 2 F ragm en t 3

espa ce ad resses 2

espace adresses 4

espace adresses 3

espace adresses 6

espace adresses 7

espace adresses 5

espa ce ad resses 1 (1 p is te )

Figure 1-10. Relation entre structure physique et structure logique d'un fichierdisque

• Les limites des espaces adresses sont indépendantes des limites des fragments.

• L'accès logique à l'intérieur des espaces adresses s'effectue au moyen des numérosde CI. En conséquence, les fichiers disque UFAS-EXTENDED peuvent être transférésd'un ensemble de fragments à un autre sans traitement spécial.

• Le transfert de fichiers UFAS-EXTENDED entre disques ne présentant pas les mêmescaractéristiques physiques (nombre de blocs, nombre de pistes par cylindre, capacitéde piste) est possible sans perte de cohérence.

La conception et l'implantation des fichiers disque sont traitées au chapitre 6.


1-14 47 F2 04UF Rev04

47 F2 04UF Rev04 2-1

2. Organisation séquentielle


• Généralités sur l'organisation séquentielle.

• Modes d'ouverture des fichiers.

• Mode d'accès aux fichiers.

• Première utilisation d'un fichier séquentiel.

• Format des CI de données dans un fichier séquentiel.


2-2 47 F2 04UF Rev04

2.2 GENERALITES SUR L'ORGANISATION SEQUENTIELLE

Un fichier séquentiel peut être enregistré sur disque ou sur bande. L'accès aux articles nepeut s'effectuer que de façon séquentielle.

Pour extraire l'article n, il faut d'abord lire tous les articles jusqu'à n-1 inclus. Après lecturede l'article n, l'instruction READ suivante lit l'article n+1.

Remarque : A noter que le GPL permet d'accéder directement à l'article n d'unfichier séquentiel sur disque. Après lecture de cet article,l'instruction READ suivante lit l'article n+1.

Il n'est possible d'écrire l'article n qu'après avoir écrit l'article n-1.

Art. 1 Art. 2 Art. 3 Art. 4 Art. (n-1) Art. n Art. (n+1)

Figure 2-1. Structure logique d'un fichier séquentiel

En COBOL, l'organisation séquentielle est déclarée par la clause ORGANIZATION ISSEQUENTIAL. Si la clause ORGANIZATION IS est omise, SEQUENTIAL est la valeurimplicite.

Organisation séquentielle

47 F2 04UF Rev04 2-3

2.3 MODES D'OUVERTURE DES FICHIERS

Lorsqu'il ouvre un fichier, l'utilisateur doit spécifier un mode d'ouverture (en COBOL, cemode est déclaré dans l'instruction OPEN). Le mode d'ouverture déclaré pour un fichierconditionne les instructions utilisables pour y accéder.

Pour un fichier séquentiel, il existe quatre modes d'ouverture :

• INPUT,

• OUTPUT,

• I-O,

• EXTEND (équivalent GPL = APPEND).

VER BECO BO L

M O DED 'O UVER-TU RE CO BO L

*I-O s 'applique uniquem ent aux fich iers d isque.

INPU TO U TPUTI-O *EXTEN D

X

X

READ W RITE

X

X

REW R ITE

X

Figure 2-2. Relation entre mode d'ouverture et mode d'accès pour un fichierséquentiel

• L'ouverture en mode OUTPUT détruit le contenu déjà existant du fichier. Il est doncpréférable de n'utiliser ce mode d'ouverture que pour le chargement initial du fichier.

• Lorsque l'ouverture s'effectue en mode EXTEND, les instructions WRITE ajoutent lesarticles en fin de fichier. A cette différence près, le mode EXTEND est équivalent aumode OUTPUT.

• En mode I-O, l'instruction REWRITE est obligatoirement précédée d'une instructionREAD (l'article à mettre à jour devant préalablement être lu). L'utilisateur ne doit pasmodifier la taille des articles de longueur variable.


2-4 47 F2 04UF Rev04

Fichiers multivolumes

Ces fichiers sont décrits de façon détaillée au chapitre 5.

Le passage automatique d'un volume au suivant s'effectue de façon différente selon lemode d'ouverture du fichier.

• En mode OUTPUT ou EXTEND :

Le système ne passe au volume suivant que lorsqu'il a utilisé toute la place réservéedans le volume courant. (A noter que le premier volume doit rester en ligne car ilcontient les informations de gestion utilisées et mises à jour par UFAS-EXTENDED).Le volume courant cesse alors d'être utilisé et les opérations d'écriture se poursuiventdans le premier fragment (extent) réservé au fichier dans le volume suivant.

• En mode INPUT ou I-O :

Le système passe au volume suivant dès qu'il a lu le dernier article dans le dernierfragment réservé au fichier dans le volume courant. Il lit alors le premier article dupremier fragment réservé dans le volume suivant.

2.4 MODE D'ACCES EN COBOL

Le seul mode d'accès possible est le mode séquentiel.

Il est déclaré par la clause ACCESS MODE IS SEQUENTIAL, et constitue la valeurimplicite.

2.5 PREMIERE UTILISATION D'UN FICHIER SEQUENTIEL

Lors de sa première utilisation, un fichier séquentiel doit de préférence être ouvert enmode OUTPUT. Les fichiers disque peuvent être ouverts en mode I-O ; mais ce n'est pasconseillé. Le chargement initial peut s'effectuer au moyen des commandes GCLLOAD_FILE (équivalent JCL = CREATE), SORT_FILE (équivalent JCL = SORT) etMERGE_FILE (équivalent JCL = MERGE), ou d'un programme COBOL.

Organisation séquentielle

47 F2 04UF Rev04 2-5

2.6 FORMAT DES CI DE DONNÉES DANS UN FICHIER SÉQUENTIEL

Les indications qui suivent permettent de mieux appréhender le mode de calcul del'espace à réserver pour un fichier (voir chapitre 6). Aucune programmation n'est requisede la part de l'utilisateur pour la mise à jour et la prise en compte des zones de gestionreprésentées à la figure 2-3. Tous les traitements nécessaires sont effectués par UFAS-EXTENDED.

Qu'il soit de longueur fixe ou variable, un article n'est jamais réparti sur deux CI. La taillede CI est toujours un multiple de 512 octets. Il peut donc rester de la place inutilisée dansun CI. UFAS-EXTENDED arrondit toujours la taille de CI spécifiée par l'utilisateur(paramètre CISIZE) au multiple de 512 immédiatement supérieur. Le tableau 6-1 fournitles tailles de CI recommandées pour chaque classe d'appareils des unités de disquesnon-FSA.

Tout article enregistré présente un en-tête de quatre octets, qui contient la longueur del'article. Les programmes utilisateur n'ont pas accès à cet en-tête. L'entité de transfertentre UFAS-EXTENDED et les programmes reste l'article, formé uniquement des zonesde données déclarées par l'utilisateur. La longueur des articles de format variable estgérée différemment selon le langage de programmation employé (en COBOL, clauseDEPENDING ON).


2-6 47 F2 04UF Rev04

Artic leEn-tête d 'a rtic le4 octets

Espace inu tilisé

En-tê te de C I 9 octets (FBO ) 8 octets (VBO )

En-tête d 'artic le4 octe tsEn-tête d 'a rtic le4 octets

En-tête d 'a rtic le4 octetsEn-tê te d 'artic le4 octetsEn-tête d 'artic le4 octe ts

A rtic le

Artic le

Artic le

Artic le

A rticle

1 octet fin deC I s i FBO

Figure 2-3. Format des CI de données dans un fichier séquentiel (articles delongueur fixe)

En-tê te d 'artic le4 octets

En-tête de C I 9 octe ts (FBO ) 8 octe ts (VBO )



Artic le 2(suite )

A rtic le 3

A rtic le 1

Artic le 2


A rtic le 3

Artic le n

e tc. (jusqu'à l'artic le n )

Espace inutilisé1 octe t finde C I s i FBO

Figure 2-4. Format des CI de données dans un fichier séquentiel (articles delongueur variable)

47 F2 04UF Rev04 3-1

3. Organisation relative


• Généralités sur l'organisation relative.

• Modes d'ouverture des fichiers.

• Modes d'accès aux fichiers.

• Mode d'accès séquentiel.

• Mode d'accès direct.

• Mode d'accès dynamique.

• Première utilisation d'un fichier relatif.

• Format des CI de données dans un fichier relatif.

• Exemple d'application.

• Avantages et inconvénients de l'organisation relative.


3-2 47 F2 04UF Rev04

3.2 GENERALITES SUR L'ORGANISATION RELATIVE

Un fichier relatif est obligatoirement sur disque. Chaque article est directement accessibleà l'aide d'un numéro d'article unique. Ainsi, pour lire l'article n, il n'est pas nécessaire delire les articles 1 à n-1 ; de même, pour écrire l'article m, il n'est pas nécessaire d'écrireles articles 1 à m-1.

Art. 1 Art. 2 Art. 3 Art. (n-1) Art. n Art. n+1 Art. m

V ide V ide

Figure 3-1. Structure logique d'un fichier relatif

Un fichier relatif est une suite de positions d'article, chacune étant identifiée par unnuméro relatif d'article (RRN - Relative Record Number), qui permet d'y accéderdirectement.

Les numéros relatifs d'article sont 1, 2, 3, etc. Le numéro le plus élevé est fonction de lataille du fichier : ainsi, dans un fichier prévu pour 1240 articles, le numéro le plus élevéest 1240.

A sa création, un fichier relatif est une succession de positions d'article vides. Toutetentative de manipuler directement une position vide se traduit par un message d'erreur.

L'accès direct à l'article n est possible même si les positions d'article 1 à n-1 sont vides(cas des positions 3 et n-1 à la figure 3-1).

Il est possible d'établir les numéros relatifs d'article soit en chargeant le fichierséquentiellement, soit en convertissant les valeurs de clé. L'utilisateur trouvera àl'annexe A quelques exemples d'algorithmes de randomisation.

En COBOL, l'organisation relative est déclarée par la clause ORGANIZATION ISRELATIVE.

Organisation relative

47 F2 04UF Rev04 3-3


A l'ouverture d'un fichier, l'utilisateur doit spécifier un mode d'ouverture. Pour un fichierrelatif, il existe quatre modes d'ouverture :

• INPUT,

• OUTPUT,

• I-O,


Le choix du mode d'ouverture est fonction du mode d'accès déclaré pour le fichier. Lesdifférentes combinaisons possibles sont décrites dans la suite de ce chapitre.

3.4 MODES D'ACCES EN COBOL

En COBOL, il existe trois modes d'accès à un fichier relatif :

{SEQUENTIAL} ACCESS MODE IS {RANDOM } {DYNAMIC }


3-4 47 F2 04UF Rev04

3.4.1 Mode d'accès séquentiel

Ce mode d'accès permet au programme de traiter séquentiellement les articles du fichier.Il autorise les quatre modes d'ouverture suivants :

INPUT

Le premier article lu est celui portant le numéro relatif 1, le second celui portant le numérorelatif 2, etc., sauf si l'instruction START est utilisée. Les positions vides sont sautées(elles ne sont pas présentées au programme). Par exemple, si la position 4 est vide, lespositions lues seront 1, 2, 3, 5, 6, etc.

Le nom de zone spécifié dans l'instruction START doit être le même que celui spécifiédans la locution RELATIVE KEY de la clause SELECT correspondante.

OUTPUT

L'ouverture en mode OUTPUT détruit le contenu existant du fichier. Les articles sontécrits aux positions 1, puis 2, puis 3, etc. Ce mode d'ouverture ne convient qu'auchargement initial du fichier.

I-O

En accès séquentiel, une instruction REWRITE ou DELETE doit toujours être précédéed'une instruction READ. La longueur réservée pour chaque position d'article étant lalongueur maximale, le nouvel article écrit avec REWRITE peut ne pas avoir la mêmelongueur que l'article recouvert.

EXTEND

VERBECO BOL

M ODED 'O UVER-TURE CO BO L

* La locution E XTE N D n 'est d ispon ib le qu'en C O B O L 85 .

READ W RITE REW RITE DELETESTART(RRN)

INPUT

OUTPUT

I-O

EXTEND*

X

X

X

X

X X

X

X

Figure 3-2. Accès séquentiel à un fichier relatif en COBOL


47 F2 04UF Rev04 3-5

3.4.2 Mode d'accès direct

En accès direct, l'instruction doit citer le numéro relatif (RRN) de l'article. C'est la valeurdonnée dans la locution RELATIVE KEY IS qui indique l'article à traiter.

VERBECO BOL


INPUT

OUTPUT

I-O

R E AD(R R N )

W RITE(RRN)

REW RITE(RRN)

DELETE(RRN)

X

X

X

X X X

Figure 3-3. Accès direct à un fichier relatif en COBOL

En mode I-O, WRITE écrit dans une position d'article vide, alors que REWRITE provoquele recouvrement d'un article déjà existant par un nouvel article. La longueur réservée pourchaque position d'article étant la longueur maximale, le nouvel article écrit avecREWRITE peut ne pas avoir la même longueur que l'article recouvert.


3-6 47 F2 04UF Rev04

3.4.3 Mode d'accès dynamique

Ce mode permet de combiner les accès séquentiel et direct. Le programmeur COBOLindique, à l'aide de l'instruction START, la position dans le fichier où l'accès séquentieldoit commencer. Les instructions sans numéro relatif d'article sont exécutées en modeséquentiel ; celles qui comportent un numéro relatif d'article peuvent être exécutées enmode direct (voir plus haut dans ce chapitre).

X

START(RRN)

X

X X

READ[RRN]

W RITE[RRN]

REW RITE[RRN]

DELETE[RRN]

VERBECO BOL


IN PUT X

I-O X X

O UTPUT X

Figure 3-4. Accès dynamique à un fichier relatif en COBOL

Pour qu'un fichier relatif soit accessible par l'instruction START, sa rubriqueFILE-CONTROL doit comporter la locution RELATIVE KEY.

3.5 PREMIERE UTILISATION D'UN FICHIER RELATIF

Lors de sa première utilisation, un fichier relatif doit être ouvert soit en mode OUTPUT,soit en mode I-O. Le chargement peut s'effectuer par la commande GCL LOAD_FILE(voir chapitre 8) ou l'ordre JCL CREATE.


47 F2 04UF Rev04 3-7

3.6 FORMAT DES CI DE DONNEES DANS UN FICHIER RELATIF

Les indications qui suivent permettent de mieux appréhender le mode de calcul del'espace à réserver pour un fichier (voir chapitre 6). Aucune programmation n'est requisede la part de l'utilisateur pour mettre à jour ou prendre en compte les zones de gestionreprésentées. Tous les traitements nécessaires sont effectués par UFAS-EXTENDED.


En-tête d 'artic le4 octets A rticle

En-tête d 'artic le4 octets





Espace inu tilisé

Position d 'a rtic le v ide

Position d 'a rtic le v ide

1 octet fin de C Is i FBO

Figure 3-5. Format des CI de données dans un fichier relatif(articles de longueur fixe)







Artic le Espaceinu tilisé




Espace inutilisé

Position d 'artic le v ide

Artic le

Position d 'artic le v ide

1 octet fin de C Isi FBO

Figure 3-6. Format des CI de données dans un fichier relatif(articles de longueur variable)


3-8 47 F2 04UF Rev04

Qu'il soit de longueur fixe ou variable, un article n'est jamais réparti sur deux CI. La taillede CI est toujours un multiple de 512 octets. Il peut donc rester de la place inutilisée dansun CI. UFAS-EXTENDED arrondit si nécessaire la taille de CI spécifiée par l'utilisateur(paramètre CISIZE) au multiple de 512 immédiatement supérieur. Le tableau 6-1 fournitles tailles de CI recommandées pour chaque classe d'appareils des unités de disquesnon-FSA.

Toute position d'article présente un en-tête de quatre octets, indiquant si elle est vide ounon.

Dans le cas des articles de format variable, la longueur réservée pour chaque positiond'article est la longueur maximale d'article. Le choix du format variable pour les articlesd'un fichier relatif doit donc être dicté par d'autres raisons que l'économie de place.

Pour les calculs d'espace, se reporter au chapitre 6.


47 F2 04UF Rev04 3-9

3.7 EXEMPLE D'APPLICATION

Soit un fichier utilisateur, dont chaque article correspond à un type de pièce détachée. Il ya 5000 types de pièces. Le fichier doit être exploité en ligne, dans une application degestion des stocks.

A la création du fichier, chaque type de pièce a reçu un numéro, de 1 à 5000. Cesnuméros figurent dans le catalogue utilisé par les clients pour commander.

GCOS 7

C ata loguedes p iècesdé tachées

Le c lient passe une com m and eté léphoniqu e en spécifian t lenum éro de p iè ce fig uran t auca ta lo gue .

L 'opéra teur in trodu itle num éro au te rm inal

A partir de ce num éro ,le p rogram m e recher-che la p ièce dans lefich ie r re la tif

F ich ierP iècesdé taché es

Figure 3-7. Exemple d'application utilisant un fichier relatif

Le format des articles enregistrés dans le fichier est le suivant :

DESIG NATIO NPIECE

ETATSTOCK

COM M ANDEM IN IM UM

PRIXUNITAIRE

SEUIL REAP-PRO VISION-

NEM ENT

DATEDISPO NIBILITE

Le programme utilisateur assure la mise à jour des articles à chaque commande. Il peuten outre enregistrer les commandes en vue de la facturation et de l'expédition.

Chaque commande est traitée sur la base des informations actualisées concernant l'étatdes stocks et les prix unitaires.

Dans ce cas, le programme travaille en accès direct (RANDOM) sur le fichier ouvert enmode I-O (mise à jour).

Si, de par leur numérotation, les pièces sont regroupées par sous-ensembles dans despositions d'articles consécutives, le programme pourra travailler en accès dynamique(DYNAMIC) pour fournir, par exemple, un listage séquentiel d'une partie du fichier auterminal.

En fin de journée ou une fois par semaine, hors du traitement en ligne, l'utilisateur pourraégalement passer un programme pour lister les articles ayant atteint ou dépassé le seuil


3-10 47 F2 04UF Rev04

de réapprovisionnement. Chaque article devant être lu, ce traitement s'effectuera enaccès séquentiel.

Pour le traitement proprement dit, même par lots, l'accès direct peut être beaucoup plusperformant que l'accès séquentiel. Par exemple, dans le cas d'un travail quotidien demise à jour portant sur 2 % des articles du fichier considéré, l'accès direct limitera lalecture à 100 articles, alors que l'accès séquentiel, dans le cas le plus défavorable,conduira à lire 5000 articles. A noter que le choix n'est possible que si le programme peutdisposer des numéros relatifs (RRN) des articles à traiter.

47 F2 04UF Rev04 4-1

4. Organisation séquentielle indexée


• Généralités sur l'organisation séquentielle indexée.• Modes d'ouverture des fichiers.• Modes d'accès aux fichiers.

- Mode d'accès séquentiel.- Mode d'accès direct.- Mode d'accès dynamique.

• Première utilisation d'un fichier séquentiel indexé.• Adjonction d'articles.• Suppression d'articles.• Clés secondaires.• Création des index secondaires.• Mise à jour des index secondaires.• Structure d'un fichier séquentiel indexé UFAS-EXTENDED.

- Espace adresses 1.- Espace adresses 2.- Espace adresses 3.- Espace adresses 4.- Espace adresses 5.- Espace adresses 6.- Espace adresses 7.

• Recherche dans l'index primaire.• Recherche dans un index secondaire.• Structure des index primaires et secondaires.• Espace libre dans les CI.• Insertion d'articles.

- Insertion sans réorganisation de CI.- Insertion avec compactage du CI.- Insertion avec réorganisation incrémentale de CI.- Insertion avec réorganisation de CI d'index.

• Format des CI de données dans un fichier séquentiel indexé.• Exemple d'application.


4-2 47 F2 04UF Rev04

4.2 GENERALITES SUR L'ORGANISATION SEQUENTIELLE INDEXEE

Un fichier séquentiel indexé est obligatoirement sur disque. Chaque article est identifiépar une valeur de zone appelée "clé". Il existe deux sortes de clés : clé primaire et cléssecondaires.

La clé primaire est la clé principale. C'est une zone de données qui doit être présentedans chaque article du fichier. Chaque article ne peut avoir qu'une seule clé primaire, etdeux articles ne peuvent avoir la même valeur de clé primaire.

Une clé secondaire peut être toute clé, autre que la clé primaire, permettant l'accès auxarticles. L'utilisateur peut spécifier jusqu'à 15 clés secondaires pour un même fichier. Lesclés secondaires sont également des zones de données constitutives des articles. Laprésence d'articles ayant une même valeur de clé secondaire peut être autorisée dans lefichier, mais les clés fractionnées sont interdites.

Pour lire un article, il est possible d'utiliser la clé primaire ou une clé secondaire. Enrevanche, pour écrire un nouvel article ou mettre à jour un article existant, seule la cléprimaire peut être employée.

ZO NE 1 ZO NE 2 ZON E 3 ZON E 4 ZO NE 5

C lé seconda ireC lé prim aire

Figure 4-1. Exemple de clés dans un article de fichier séquentiel indexé

La longueur et l'emplacement de chaque clé doivent être les mêmes pour tous lesarticles. L'emplacement d'une clé (sa position par rapport au début d'un article) est définipar l'utilisateur à la création du fichier. Chaque clé est identifiée par son emplacement etsa longueur ; deux clés ne peuvent donc pas se trouver au même emplacement et avoirla même longueur (voir chapitre 6 pour plus de détails). Néanmoins, deux clés peuventavoir la même valeur de KEYLOC (position du premier octet de la clé dans l'article).

N'importe quelle zone de données peut être choisie comme clé d'article. Dans les articlesde longueur variable, les zones clés définies par l'utilisateur doivent toujours êtreprésentes.

Organisation séquentielle indexée

47 F2 04UF Rev04 4-3

LA LONGUEUR DE CLÉ NE PEUT DÉPASSER251 OCTETS, ET UNE CLÉ NE PEUT ÊTRE

FRACTIONNÉE.

En plus de l'espace réservé aux données, un fichier séquentiel indexé contient desespaces réservés aux index (voir figure 1-4). Les index permettent de relier la valeur declé définie par l'utilisateur et l'adresse (position physique) de l'article recherché. End'autres termes, les index servent à localiser les articles. Ces index sont gérés parUFAS-EXTENDED.

Soit un fichier Commandes avec :

• une clé primaire : le numéro de commande ;

• deux clés secondaires : le numéro de client et le numéro de produit.

101 391 0 8 9 1

102 201 0 3 7 1

179 391 0 8 9 3

213 251 0 8 9 1

N u m é roC o m m a n d e

N u m é roC lie n t

N u m é roP ro d u it

Q U A N TITEA D R E S S EC L IE N T

A D R E S S EC L IE N T

Q U A N TITE

Q U A N TITEA D R E S S EC L IE N T

A D R E S S EC L IE N T

Q U A N TITE

V a leu rs d e c léide n tiq u e s

no n a u to risé e s

V a leu rs d e c léide n tiq u e sa u to risé e s


4-4 47 F2 04UF Rev04

• Le client 391 a passé deux commandes (101 et 179) concernant deux produitsdifférents (891 et 893).

• Le produit 891 a été commandé par deux clients différents (391 et 251).

Les index sont utilisables :

• pour l'accès séquentiel aux articles, c'est-à-dire selon l'ordre des numéros decommande dans l'exemple considéré ;

• pour l'accès dynamique aux articles, c'est-à-dire en fonction d'une valeur de clé donnéepar l'utilisateur (exemple : extraction de toutes les commandes passées par leclient 391).

En COBOL, l'organisation séquentielle indexée est déclarée par la clauseORGANIZATION IS INDEXED.


47 F2 04UF Rev04 4-5


Lorsqu'il ouvre un fichier, l'utilisateur doit spécifier un mode d'ouverture. Pour un fichierséquentiel indexé, il existe quatre modes d'ouverture :

• INPUT,

• OUTPUT,

• I-O,


Le mode EXTEND, qui est une possibilité récente offerte par UFAS-EXTENDED, n'estdisponible qu'en COBOL-85.

Le choix du mode d'ouverture est fonction du mode d'accès déclaré pour le fichier. Lesdifférentes combinaisons possibles sont décrites dans la suite de ce chapitre.


4-6 47 F2 04UF Rev04

4.4 MODES D'ACCES EN COBOL-85

En COBOL, il existe trois modes d'accès à un fichier séquentiel indexé :

{SEQUENTIAL} ACCESS MODE IS {RANDOM } {DYNAMIC }

4.4.1 Mode d'accès séquentiel en COBOL-85

C'est le mode d'accès à utiliser lorsque tous les articles du fichier sont à traiter. Il permetl'ouverture en mode INPUT, OUTPUT ou I-O.

Ouverture en mode INPUT et I-O :

• Le programme lit les articles dans l'ordre croissant des valeurs de clés primaires ousecondaires. En cas d'accès sur clé secondaire, si plusieurs articles ont la mêmevaleur de clé, le programme lit les homonymes dans l'ordre où ils ont été écrits.

• L'instruction START permet d'indiquer la position dans le fichier où doit commencer letraitement.

Ouverture en mode I-O seulement :

• Avec l'instruction REWRITE (obligatoirement précédée d'une instruction READ), lavaleur de la clé primaire doit être conservée.

Mode OUTPUT :

• L'ouverture en mode OUTPUT détruit le contenu déjà existant du fichier.

• Ce mode d'ouverture ne doit être utilisé que pour le chargement initial des données.Pour ce faire, il est possible d'utiliser la commande LOAD_FILE (voir chapitre 8), l'ordreJCL CREATE, ou un programme COBOL.

• Le programme doit écrire les articles dans l'ordre croissant des valeurs de clé primaire.

Mode EXTEND :

• Ce mode n'est disponible qu'en COBOL-85. Les articles doivent être écrits dans l'ordrecroissant des valeurs de clé primaire.


47 F2 04UF Rev04 4-7

V E R B EC O B O L

M O D ED 'O U V E R -TU R E C O BO L

IN P U T

O U TP U T

I-O

E X T E N D

R E A D W R IT E R E W R IT E D E L E T ES TA R T

(C lé )

X

X

X X

X

X

X

X

Figure 4-2. Accès séquentiel à un fichier séquentiel indexé en COBOL


4-8 47 F2 04UF Rev04

4.4.2 Mode d'accès direct

L'accès direct aux articles d'un fichier séquentiel indexé s'effectue à l'aide d'une clé. Enlecture, le programme doit fournir la valeur de clé de l'article (clé primaire ou secondaire).En écriture, c'est la valeur de la clé primaire qui est utilisée pour ranger l'article dans lefichier.

Toutes les valeurs de clé primaire doivent être uniques dans le fichier.

V E R B EC O B O L


R E A D(c lé )

W R IT E(c lé )

R E W R IT E(c lé )

D E L E T E(c lé )

IN P U T

O U T PU T

I-O

X

X

X

X X X

Figure 4-3. Accès direct à un fichier séquentiel indexé en COBOL

Lorsque le fichier a été ouvert en mode I-O :

• L'instruction WRITE ajoute un nouvel article au fichier (avec une nouvelle valeur de cléprimaire).

• L'instruction REWRITE provoque le recouvrement d'un article existant par un nouvelarticle de même longueur et de même valeur de clé primaire.


47 F2 04UF Rev04 4-9

4.4.3 Mode d'accès dynamique

L'accès dynamique permet de combiner les accès séquentiel et direct dans un mêmeprogramme. Le programmeur COBOL indique à l'aide de l'instruction START la positiondans le fichier où l'accès séquentiel doit commencer. Les instructions qui ne spécifientpas de valeur de clé sont exécutées en mode séquentiel ; celles qui comportent unevaleur de clé peuvent être exécutées en mode direct (voir paragraphe 4.4.2).


V E R B EC O B O L

IN P U T

O U T PU T

I-O

R E A D[c lé ]

W R IT E[c lé ]

R E W R IT E[clé ]

D E L E T E(c lé )

S T A R T(c lé )

X

X

X

X X X

X

X

Figure 4-4. Accès dynamique à un fichier séquentiel indexé en COBOL

En accès dynamique, les règles d'utilisation de l'instruction WRITE dépendent du moded'ouverture spécifié :

IMPORTANT

Avec un fichier ouvert en mode OUTPUT ou EXTEND :

les articles doivent être écrits dans l'ordre croissant des valeurs de cléprimaire. Cet ordre est particulièrement important en mode EXTEND.

Avec un fichier ouvert en mode I-0, cette contrainte n'existe pas.


4-10 47 F2 04UF Rev04

4.5 PREMIERE UTILISATION D'UN FICHIER SEQUENTIEL INDEXE

Lors de sa première utilisation, un fichier séquentiel indexé doit être ouvert soit en modeOUTPUT, soit en mode I-O. Le chargement initial peut s'effectuer par la commande GCLLOAD_FILE (voir chapitre 8) ou l'ordre JCL CREATE.

Il est préférable de choisir le mode OUTPUT. Si le fichier comporte des clés secondaires,exécuter l'utilitaire SORT_INDEX ou l'ordre JCL SORTIDX une fois le fichier chargé.Spécifier également la clause APPLY NO-SORTED-INDEX dans le programme COBOL.

4.6 ADJONCTION D'ARTICLES

L'adjonction d'articles n'est possible que s'il reste assez d'espace dans le fichier pour lesrecevoir. Les valeurs de clé primaire (uniques) de ces nouveaux articles peuvent êtresituées indifféremment à l'extérieur ou à l'intérieur de la plage déjà existante dans lefichier.

Il convient de prévoir à la création du fichier suffisamment d'espace pour permettre desextensions ultérieures (voir chapitre 6).

4.7 SUPPRESSION D'ARTICLES

La place occupée par les articles supprimés est réutilisable pour des insertionsultérieures. Pour plus de détails, voir plus loin dans ce chapitre "Insertion aveccompactage du CI".


47 F2 04UF Rev04 4-11

4.8 CLES SECONDAIRES

Dans un fichier séquentiel indexé, l'utilisateur peut définir jusqu'à 15 clés secondaires. Ilest possible d'autoriser dans le fichier des articles présentant une valeur identique pour lamême clé secondaire. Chaque clé secondaire nécessite la création d'un index.

Dans le cas d'une application TDS, limiter à 2 ou 3 le nombre de clés secondaires. Eviterde choisir des clés secondaires ayant comme valeur SPACE ou ZERO.

4.8.1 Création des index secondaires

Il existe deux modes de création des index secondaires, mais il est préférable de choisirle premier :

1. Les articles sont déjà chargés et triés sur la clé primaire. Pour charger le fichier(chargement initial), l'utilisateur a le choix entre :

- la commande GCL LOAD_FILE (équivalent JCL = CREATE),

- un programme COBOL (instructions WRITE) avec clause APPLY NO-SORTED-INDEX ON et ALTERNATE RECORD KEY dans la clause SELECT.

Une fois les articles enregistrés dans le fichier, la commande SORT_INDEX(SRTIDX) - équivalent JCL = SORTIDX - trie les clés secondaires et les place dansles index secondaires qu'elle crée.

2. UFAS-EXTENDED constitue automatiquement les index secondaires lorsque lefichier a été :

- ouvert en mode I-O (mise à jour) ;

- créé au moyen de la commande GCL LOAD_FILE avec ORDER = 0(équivalent JCL : CREATE avec FILELOAD = NORDER) ;

- créé au moyen d'un programme COBOL sans la clause APPLY NO-SORTED-INDEX (fichier ouvert en mode OUTPUT).

Un article nouvellement inséré est donc immédiatement accessible au moyen de saclé primaire ou d'une clé secondaire.

Format simplifié de SRTIDX :

SRTIDX [ OUTFILE = ] (description-fichier-sortie )


4-12 47 F2 04UF Rev04

Exemple :

S:SRTIDX (SD3.IQS.CLIENTS)

Dans cet exemple, SD3.IQS.CLIENTS est le fichier dont les index secondaires sont àcréer. Les clés enregistrées dans l'index secondaire sont triées en ordre croissant.

Pour plus de détails sur l'utilitaire SRTIDX, se reporter au volume 2 du manuel deréférence de l'utilisateur IOF (22UJ/23UJ) ; l'équivalent JCL SORTIDX est décrit dans lemanuel traitant des utilitaires de gestion de données (26UF).

Les index secondaires sont donc créés automatiquement :

• lorsque le chargement initial est effectué par un programme COBOL ne contenant pasla clause APPLY NO-SORTED-INDEX ON dans l'I-O-CONTROL SECTION del'ENVIRONMENT DIVISION ;

• lorsqu'un programme ouvre le fichier en mode I-O.

Dans ces deux cas, des articles ayant la même valeur de clé sont écrits dans leur ordred'arrivée (et non triés sur la clé primaire, comme avec SORTIDX).

Pour optimiser les performances lors d'un chargement initial du fichier par programmeCOBOL en mode OUTPUT ou EXTEND, insérer la clause APPLY NO-SORTED-INDEXON. Cette clause n'est prise en compte que si le fichier est ouvert en mode sortie .

Pour plus de précisions sur la clause APPLY NO-SORTED-INDEX ON, consulter lemanuel de référence COBOL 85 (05UL).

4.8.2 Mise à jour des index secondaires

Conformément à la norme COBOL ANSI, la mise à jour des index secondaires s'effectueen même temps que celle des articles, sans aucune intervention de l'utilisateur.


47 F2 04UF Rev04 4-13

4.9 STRUCTURE D'UN FICHIER SEQUENTIEL INDEXE UFAS-EXTENDED

Il est nécessaire de connaître la structure d'un fichier séquentiel indexé pour pouvoirinterpréter les informations fournies par la commande LIST_FILE (équivalentJCL = FILLIST). Si, par exemple, de nombreuses réorganisations incrémentales de CI onteu lieu, il faudra restructurer le fichier avec davantage d'espace libre dans les CI.

Un fichier séquentiel indexé peut comporter jusqu'à sept espaces adresses (voirfigure 4-5). Les espaces adresses 3, 4, 5, 6 et 7 sont propres aux fichiers séquentielsindexés.

4.9.1 Espace adresses 1

L'espace adresses 1 regroupe les CI de gestion réservés à UFAS-EXTENDED. Il occupetoujours au minimum les premiers blocs ou 16 Ko (FBO), ou la première piste (VBO) del'espace réservé au fichier.


L'espace adresses 2 regroupe les CI de données contenant les articles utilisateur.


L'espace adresses 3 regroupe les CI du niveau supérieur de l'index primaire (dansl'organisation séquentielle indexée). Il peut être vide dans le cas d'un fichier de petite tailleà un seul niveau d'index.


L'espace adresses 4 regroupe les CI du niveau inférieur de l'index primaire, renvoyantaux CI de données.


4-14 47 F2 04UF Rev04


L'espace adresses 5 regroupe les CI de l'"index dense", c'est-à-dire les CI d'index duniveau le plus bas, lorsque l'accès aux données s'effectue par clé secondaire. Cet indexest dit "dense" parce qu'il contient une rubrique par article pour chaque index secondaire.Ainsi, dans un fichier de 100 articles comportant chacun trois clés secondaires, l'espaceadresses 5 aura 100 x 3 = 300 rubriques.

L'espace adresses 5 n'existe que pour les fichiers séquentiels indexés avec cléssecondaires.


A chaque clé secondaire spécifiée pour le fichier correspond un index dont la structure estla même que celle de l'index primaire.

L'espace adresses 6 regroupe les CI d'index de niveau supérieur associés à chaque clésecondaire. Il joue le même rôle pour les index secondaires que l'espace adresses 3 pourl'index primaire.

L'espace adresses 6 n'existe que pour les fichiers séquentiels indexés avec cléssecondaires.


47 F2 04UF Rev04 4-15


L'espace adresses 7 regroupe les CI d'index de niveau inférieur associés à chaque clésecondaire. Il joue pour les index secondaires le même rôle que l'espace adresses 4 pourl'index primaire.

CI

CI

CI

CI

CI

CI

CI

CI

CI

CI

CI

CI

CI

CI

CI

CI

CI

CI

CI

E spaces adresses

C I d 'ind ex p r im a ire du n ivea u le p lus b as

C I d 'ind e x p rim a ire d e n ive au s up érie u r

C I d 'in d ex se con da ires d e n ive au s up é rie u r

C I d 'in d e x se co nd a ire s du n ive au le p lu s b a s

C I d 'ind e x s eco nd a ire s du n ive a u d en se

1 3 4 2 6 7 5

L e s z on es e n g r isé re p ré sen te n t d e l'es pa ce lib re .

In fo rm a tio n s d e g e s tio n (g é rée s pa rU F A S -E X T E N D E D )

Figure 4-5. Structure logique d'un fichier séquentiel indexé


4-16 47 F2 04UF Rev04

4.9.8 Recherche dans l'index primaire

Un index primaire comporte généralement plusieurs niveaux. Dans un index à un seulniveau et au niveau le plus bas d'un index à plusieurs niveaux, une rubrique renvoiedirectement à un CI de données. Aux niveaux les plus élevés d'un index à plusieursniveaux, une rubrique renvoie à un CI d'index du niveau directement inférieur. Lorsque lataille d'un fichier est importante, il est utile d'avoir plusieurs niveaux d'index, afin deréduire le temps de recherche.

La figure 4-6 représente :

• l'espace adresses 3 qui regroupe les CI d'index primaire du niveau supérieur ;• l'espace adresses 4 qui regroupe les CI d'index primaire du niveau inférieur ;• l'espace adresses 2 qui regroupe les CI de données.

Chaque CI d'index contient des rubriques d'index.

La taille des CI est la même dans tous les espaces adresses (y compris dans l'espaceadresses 2).

L'index primaire prend en compte l'ordre des articles. Il comporte une seule rubrique parCI de données ; cette rubrique contient la valeur de clé primaire la plus élevée du CIauquel elle permet d'accéder. Le classement par ordre croissant des valeurs de clépermet à UFAS-EXTENDED de repérer les valeurs qui ne figurent pas dans l'index.

• UFAS-EXTENDED génère autant de niveaux supérieurs d'index qu'il est nécessairepour qu'il suffise d'explorer un seul CI à chaque niveau afin d'accéder à l'article voulu.

• Chaque rubrique d'index contient la valeur de clé primaire la plus élevée du CI auquelelle permet d'accéder. Ainsi, dans la figure 4-6 où les clés ont trois caractères, la valeurde clé primaire la plus élevée du 17ème CI est EAP.

Supposons que nous voulions extraire l'article dont la valeur de clé est JFO. UFAS-EXTENDED commence au niveau d'index le plus haut (CI d'index RST). Dans ce CI,UFAS-EXTENDED trouve la rubrique JKA, qui renvoie au CI d'index de niveau le plusbas : CI JKA dans l'espace adresses 4. Dans ce CI, UFAS-EXTENDED trouve la rubriqued'index JKA qui renvoie au 18ème CI de données. UFAS-EXTENDED conclut que la cléJFO, si elle existe, se trouve dans le 18ème CI.

4.9.9 Recherche dans un index secondaire

Un fichier peut avoir jusqu'à 15 clés secondaires. En environnement transactionnel, il estrecommandé, pour optimiser les performances, de n'utiliser qu'un nombre réduit de cléssecondaires. Les index de ces clés sont rangés dans les espaces adresses 5, 6 et 7 (voirfigure 4-5).


47 F2 04UF Rev04 4-17

E U L

F IB

JKA

H A A

R A A

PN Z

R S T

R E B

A C C

AD E

EA P

BID

KL M

K R R

N O U

P N N

LLL

C I 1 7 C I 18 C I 19 C I 20

B U D

C C E

EA P

D E A

D IA

H A B

G IA

G LL

JKA

JF O

E AP

JKA

P N N

R ST

N O P

P N N

P LA

P AA

R EA

R FU

R ST

C I d 'in de x du n ive au le p lu s é le vé

Espace adresses 3

Espace adresses 4

Espace adresses 2

C Id edo nné e s

. . .C I1 à 16

. . .

. . .C I21 à n

. . .

Figure 4-6. Structure de l'index primaire dans un fichier séquentiel indexé sans cléssecondaires


4-18 47 F2 04UF Rev04

4.9.10 Structure de l'index primaire et secondaire

La figure 4-7 montre l'accès aux CI de données de l'espace adresses 2 par les différentsindex (primaire et secondaires) pour un fichier à deux clés secondaires. Pour simplifier,cet exemple ne comporte que 5 rubriques par CI d'index, mais ce nombre est beaucoupplus important en réalité.

Index secondaire 2Index secondaire 1

Espace adresses 6C I d 'in de x se co nd a ire sno n d e n se s de n ive ausu p é rie u r

Espace adresses 7C I d 'in de x se co nd a ire sno n d e n se s du n ive aule p lu s b a s

Espace adresses 5Index denses

Espace adresses 2C I d e d on né e s

Espace adresses 4C I d 'ind ex p rim a ire dun ive au le p lus b as

Espace adresses 3C I d 'ind ex p rim a ire den ive au su p érie u r

Figure 4-7. Structure des index secondaires dans un fichier séquentiel indexé avecclés secondaires


47 F2 04UF Rev04 4-19

4.10 ESPACE LIBRE DANS LES CI

A la création du fichier (voir chapitre 6), l'utilisateur peut spécifier, au moyen du paramètreCIFSP de la commande BUILD_FILE (équivalent JCL = PREALLOC), le pourcentaged'espace libre à laisser dans chaque CI lors du chargement initial en mode OUTPUT (afinde permettre des insertions ultérieures d'articles).

C I 0 C I 1 C I 2 C I 3 C I 4 C I 5

Figure 4-8. Espace libre dans un fichier séquentiel indexé

Les zones en grisé représentent l'espace libre.


4-20 47 F2 04UF Rev04

4.11 INSERTION D'ARTICLES

UFAS-EXTENDED fournit automatiquement de nouveaux CI dans l'espace alloué enfonction des besoins. Lorsqu'un nouvel article doit être inséré dans le fichier, il commencepar lire le CI auquel l'article devrait logiquement appartenir (d'après la valeur de sa cléprimaire), puis, suivant le cas, applique l'un des mécanismes d'insertion décrits ci-après.

4.11.1 Insertion sans réorganisation de CI

Dans ce cas, il reste suffisamment d'espace dans le CI considéré pour intégrer l'article,sans nécessité d'une réorganisation.

C I (F X X)

FA B

F B B

FNA

FN Q

FDM

FX X

C I (FX X )

FLX

FLX

FA B

FB B

FNA

FN Q

FDM

F X X

C lé

A rt ic le à in sé re r

E n-tê te de C I E n-tê te de C I

D esc rip te u rs d 'a rtic leD esc rip te u rs d 'a rtic le

Figure 4-9. Insertion sans réorganisation de CI

Chaque article du CI contient un pointeur renvoyant à l'article suivant (valeur de cléimmédiatement supérieure). L'ordre physique des articles dans le CI ne correspond pas àl'ordre logique, établi en fonction des valeurs de clé. Ces pointeurs assurent le chaînagedes articles dans le CI.

Les descripteurs d'article sont traités plus loin dans ce chapitre (voir paragraphe 4.12).


47 F2 04UF Rev04 4-21

4.11.2 Insertion avec compactage du CI

Dans ce cas, il reste suffisamment d'espace pour l'insertion dans le CI considéré (suite àdes suppressions d'articles), mais UFAS-EXTENDED doit le compacter. Ce compactageest illustré par la figure 4-10 (le chaînage des articles n'est pas représenté) ; à noter quel'ordre des articles n'est pas modifié.

C I (F XX )

F A B

F B B

FD M F N A

F N Q

F P X

F A B

F B B F D M

F X X

F X X

C I (F X X )

F N Q

F N A F P X

C lé

A rtic le à in sé re r

En -tê te de C IEn-tê te de C I

E spacelib re

E sp ace lib re E sp ace lib re

D escr ip teu rs d 'a rtic leD escrip teu rs d 'artic le

E sp ace lib re

E sp ace lib re

Figure 4-10. Insertion avec compactage du CI

Les CI contenant des articles de longueur variable nécessitent un compactage fréquent.UFAS-EXTENDED compacte les articles du CI en regroupant la totalité de l'espace libre àla fin. L'insertion du nouvel article est effectuée au cours de cette opération. Lecompactage des CI sans réorganisation (à la différence des versions précédentesd'UFAS) économise la mise à jour de l'espace adresses 5.


4-22 47 F2 04UF Rev04

4.11.3 Insertion avec réorganisation incrémentale de CI

Dans ce cas, il ne reste pas assez d'espace dans le CI considéré pour insérer un article.UFAS-EXTENDED doit donc trouver un autre CI, comme l'illustre la figure 4-11ci-dessous.

B L BDBXDBA

DBZELGDCZG H HGHAD C CE F FF A B

P L XPRAPVBSMXN E RG H I

F P A

DBXG H HSMX

B LBDBXDBA

D C CDBZ

DCZE F FELG

P L XPRAPVBSMXN E RG H I

FA BFP AGHAG H H

DBXELGG H HSMX

C I d 'in d e x (S M X )

R u b riq ue s d 'ind exv ide s

Espaceadresses 4

Index du niveau le plus bas

Espaceadresses 2


A v an t ré o rga n isa tion d e C IA p rès réo rg an isa tio n de C I

C I (D B X ) C I (G H H ) C I (S M X ) C I (lib re )

C I d 'in d e x (S M X )

Espaceadresses 4

Index du niveaule plus bas

C I (G H H )C I (S M X )C I (D B X ) C I (E LG )

Espaceadresses 2

Figure 4-11. Insertion avec réorganisation incrémentale de CI


47 F2 04UF Rev04 4-23

UFAS-EXTENDED éclate le CI GHH : les articles DBZ, DCC, DCZ, EFF et ELG restentdans l'ancien CI GHH, qui devient le CI ELG, et l'article FPA est placé avec les articlesGHH, GHA et FAB dans le nouveau CI GHH.

Noter le chaînage entre les CI, qui rend possible l'accès séquentiel.

Les rubriques vides des CI d'index sont gérées automatiquement par UFAS-EXTENDED ;à noter que les CI d'index comportent généralement beaucoup plus de rubriques quedans l'exemple.

IMPORTANT

Si un fichier avec index secondaires utilisant le mécanisme de mise àjour différée fait l'objet d'une réorganisation interne de CI, cemécanisme n'est plus pris en compte, et le système émet le coderetour WDNAV. En revanche, la mise en oeuvre du journal Avant estautomatique.

4.11.4 Insertion avec réorganisation de CI d'index

Dans le cas précédent, où l'insertion nécessitait une réorganisation incrémentale de CI, ilexistait au moins une rubrique d'index vide. Lorsqu'il n'existe aucune rubrique d'indexvide, UFAS-EXTENDED utilise des mécanismes plus complexes.

Le contenu d'un CI d'index de niveau inférieur est éclaté en deux CI d'index. Cetteopération ne provoque aucun déplacement d'articles de données ; seuls les CI d'indexsont touchés. Par ailleurs, une rubrique est créée dans l'index de niveau supérieur(espace adresses 3 ou 6), ce qui peut entraîner la réorganisation des index de niveausupérieur.

A la figure 4-12, l'article ayant la valeur de clé 1210 doit être inséré dans le CI dedonnées 13. Celui-ci étant saturé, il faut l'éclater ; mais il n'y a aucune rubrique vide dansl'espace adresses 4.

Dans la partie droite de la figure, le CI d'index 1786 est éclaté, ce qui libère de la placepour la rubrique d'index 1100. Puis il y a éclatement du CI de données 13. Les articlesayant les clés 1000, 1020 et 1100 sont insérés dans le nouveau CI de données (nn) ;l'article 1214 reste dans le CI de données 13, où vient également s'insérer le nouvelarticle 1210.


4-24 47 F2 04UF Rev04

10 00

1 02 0

1210

C I 1 2C I 1 3

C I 1 4C I 1 5

C I 1 2C I 1 3C I 1 4C I 1 5

1000

1100

1214

1020

12101 21 4


Espaceadresses 4

C I d 'in de x (4 3 12 ) C I d 'in de x (4 3 12 )

E n-tê te de C I E n-tê te de C I

E n-tê te de C I

E n-tê te de C I

c lé = 0 41 9c lé = 1 78 6c lé = 4 31 2L ib re

AVANT APRES

c lé = 04 1 9

c lé = 17 8 6c lé = 12 1 4

c lé = 43 1 2

c lé = 06 1 3c lé = 12 1 4c lé = 11 0 0L ib re

c lé = 0 61 3c lé = 1 21 4c lé = 1 31 6c lé = 1 78 6

c lé = 13 1 6c lé = 17 8 6L ib reL ib re

C I de d o n né es (nn )

C I de d o n né es (13 )

E n-tê te de C I

E n-tê te de C I

E n-tê te de C I

E n-tê te de C I

1 10 0

Espaceadresses 2

C I de d o n né es (13 )

Espaceadresses 2

Espaceadresses 4

Espaceadresses 3

Espaceadresses 3

C l d 'ind e x (17 8 6 )

C l d 'inde x (1 2 1 4)

C l d 'inde x (1 7 8 6)

Figure 4-12. Insertion avec réorganisation de CI d'index


47 F2 04UF Rev04 4-25

4.12 FORMAT DES CI DE DONNEES DANS UN FICHIER SEQUENTIELINDEXÉ

Les informations qui suivent sont destinées à aider l'utilisateur pour le calcul d'espace.

A noter que les en-têtes et les descripteurs d'article représentés à la figure 4-13ci-dessous sont créés, gérés et utilisés par UFAS-EXTENDED et ne nécessitent aucuneprogrammation utilisateur.

R D (H ) R D (G ) R D (C )

R D (B ) R D (A )R D (E ) R D (D ) R D (I)

E n -tê te de C I20 octe ts (V BO )

E n -tê te d 'a rtic le5 o cte ts


A rtic le A

A rtic le B E n -tê te d 'a rtic le5 o cte ts

A rtic le I


A rtic le EE n -tê te d 'a rtic le5 o cte ts

A rtic le C


A rtic le H


A rtic le F

21 o cte ts (FBO )


A rtic le D


A rtic le G

RD (F)

1 octet fin deCI si FBO

Figure 4-13. Format des CI de données dans un fichier séquentiel indexé (articlesde longueur fixe ou variable)

Chaque descripteur d'article (RD) a une longueur de deux octets, et chaque en-têted'article une longueur de cinq octets.

Les zones en grisé représentent l'espace libre ; à noter qu'il peut s'agir d'articlessupprimés logiquement, mais pas encore physiquement.


4-26 47 F2 04UF Rev04

Commentaires relatifs à la figure 4-13 :

• Le nombre maximal d'articles autorisé dans un CI est de 255.

• Dans un fichier séquentiel indexé, un CI doit pouvoir contenir au moins deux articles.

• Chaque CI contient un descripteur d'article (RD) par article valide. Dans la figure 4-13,les articles D et G sont signalés comme étant supprimés. Or des articles suppriméslogiquement ne le sont pas immédiatement physiquement ; leurs descripteurs peuventpar conséquent être vides ou non (voir "Insertion avec compactage du CI" plus haut).

• Les descripteurs d'article servent de pointeurs d'articles (ils indiquent la position del'article par rapport à l'en-tête de CI).

• La taille de CI doit être un multiple de 512 octets. L'utilisateur peut spécifier un nombrede cinq chiffres maximum : UFAS-EXTENDED l'arrondit si nécessaire au multiplede 512 immédiatement supérieur. Les tableaux 6-1 et 6-2 donnent les tailles de CIrecommandées pour les différentes unités de disques en fonction de leur architecturematérielle (non-FSA ou FSA).

• Pour plus de détails sur les calculs d'espace, se reporter au chapitre 6.


47 F2 04UF Rev04 4-27

4.13 EXEMPLE D'APPLICATION

Soit le fichier Personnel d'une grande entreprise. Ce fichier comporte un article paremployé. Le format de chaque article est le suivant :

N om d el'em p loyé

A dressesN ° d e

S é curitéS o c ia le

N o m e ta d re sse d up a re n t le p lu s p ro ch e

D a te d en a issa nc e

D a ted 'e m b a uch e

N iveau dequa lifica tion

L'accès doit s'effectuer en mode non séquentiel. L'utilisateur a donc le choix entre uneorganisation relative et une organisation séquentielle indexée.

• S'il choisit l'organisation relative, il devra attribuer un numéro relatif d'article (RRN) àchaque employé. Cette solution manque de souplesse car, pour des raisons desécurité, les RRN des employés quittant l'entreprise ne pourront être réattribués auxnouveaux embauchés, et le fichier sera plus ou moins rapidement encombré de RRN(donc de positions d'articles) inutilisables.

• Par contre, s'il choisit l'organisation séquentielle indexée avec le numéro de sécuritésociale (unique) comme clé primaire, la place occupée par les articles suppriméspourra être réutilisée par de nouveaux articles présentant de nouvelles valeurs de clé.


4-28 47 F2 04UF Rev04

47 F2 04UF Rev04 5-1

5. Fichiers disque et bande - Affectation,gestion des tampons et intégrité


• Paramétrage des fichiers en GCL/JCL.

• Paramétrage des fichiers dans les programmes utilisateur.

• Groupe de paramètres ASGn (affectation de fichiers).

• Types de volumes.

- Volumes résidants.- Volumes de manoeuvre.- Volumes nommément désignés.

• Fichiers multivolumes.

- Traitement partiel/extension du nombre de volumes.- Gestion du nombre d'appareils mobilisés (paramètre MOUNT).

• Pools d'appareils (paramètre POOL).

• Partage de fichier (paramètre SHARE).

• Règles de recouvrement des valeurs de paramètres.

• Groupe de paramètres DEFn (définition de fichiers).

• Gestion des tampons en traitement par lots/IOF.

- Paramètre POOLSIZE.- Paramètre BUFPOOL.- Paramètre NBBUF.- Optimisation des paramètres de gestion des tampons.- Statistiques UFAS-EXTENDED figurant dans le JOR.


5-2 47 F2 04UF Rev04

• Journalisation.

- Journal Avant (Before).- Journal Après (After).

• Maintien de l'intégrité des fichiers.

- Phase de création.- Phase de traitement.- Phase d'extension.- Erreurs E/S persistantes.

Fichiers disque et bande - Affectation, gestion des tampons et intégrité

47 F2 04UF Rev04 5-3

5.2 PARAMETRAGE DES FICHIERS EN GCL

En environnement IOF, la réservation d'espace pour les fichiers et leur affectation autraitement s'effectuent au moyen du langage GCL (langage de commande GCOS 7).

Le paramétrage des fichiers dans la commande GCL EXEC_PG est réalisable à l'aidedes groupes suivants :

ASGn Groupe de paramètres d'affectation d'un fichier auprogramme à exécuter (voir plus loin dans ce chapitre).

ALCn Groupe de paramètres de réservation d'espace pour unfichier disque permanent ou temporaire (voir chapitre 6).

A noter par ailleurs que les paramètres DYNALC etALLOCATE des commandes COPY_FILE etCOMPARE_FILE permettent de demander la réservationdynamique d'espace pour un fichier.

DEFn Groupe de paramètres de définition d'un fichier (attributs etoptions de traitement) (voir chapitre 6). Ces attributs etoptions peuvent aussi être spécifiés au moyen desparamètres INDEF et OUTDEF d'un utilitaire de gestion defichiers.

En ce qui concerne les pools d'appareils et de tampons, les paramètres utilisables sontles suivants :

POOL Paramètre de définition du pool d'appareils réservé à l'usagedu programme (voir plus loin dans ce chapitre).

POOLSIZE Paramètre de définition du pool de tampons (taille maximalede la mémoire tampon) (voir plus loin dans ce chapitre).

Ces éléments du langage GCL ne sont traités ici que du point de vue des fichiers UFAS-EXTENDED. Leur description complète est fournie dans le volume 2 du manuel deréférence de l'utilisateur IOF.


5-4 47 F2 04UF Rev04

5.3 PARAMETRAGE DES FICHIERS EN JCL

En environnement Traitement par lots ou TDS, la réservation d'espace pour les fichiers etleur affectation au traitement s'effectuent en langage JCL (langage de gestion destravaux).

Le paramétrage des fichiers dans la description du travail est réalisable au moyen desordres JCL suivants :

ASSIGN Affectation d'un fichier au programme à exécuter.

ALLOCATE Réservation d'espace pour un fichier disque permanent outemporaire.

DEFINE Définition d'un fichier (attributs et options de traitement) ;détermine notamment le nombre de tampons affectés à unfichier (paramètre NBBUF).

En ce qui concerne les pools d'appareils et de tampons, les ordres JCL utilisables sontles suivants :

POOL Introduction d'un ou de plusieurs appareils dans le poolréservé à l'usage du programme.

SIZE Spécification de la taille de l'espace d'exécution (DWS) et decelle de la mémoire tampon (paramètre POOLSIZE).

Ces éléments du langage JCL ne sont traités ici que du point de vue des fichiers UFAS-EXTENDED. Leur description complète est fournie dans le manuel de référence dulangage JCL.

Par ailleurs, la réservation dynamique d'espace pour un fichier peut se faire au moyen duparamètre OUTALC de l'utilitaire CREATE. Les paramètres INDEF et OUTDEF desutilitaires de gestion de données fournissent les attributs de fichier à utiliser par UFAS-EXTENDED. Voir le guide utilisateur consacré aux utilitaires de gestion de données.


47 F2 04UF Rev04 5-5

5.4 PARAMETRAGE DES FICHIERS DANS LES PROGRAMMESUTILISATEUR

Les programmes COBOL sont indépendants des attributs physiques des fichiers à traiter.

Dans un programme utilisateur, chaque fichier est désigné par un nom symboliquen'ayant pas nécessairement de rapport avec son nom véritable. Ce nom symbolique estappelé "nom de fichier interne", par opposition au nom véritable du fichier (c'est-à-dire sonnom d'accès), appelé "nom de fichier externe". L'association du nom de fichier interne aunom de fichier externe doit être effectuée lors de la demande d'exécution du programme.Cette opération s'appelle affectation de fichier (voir paragraphe "Groupe de paramètresASGn" plus loin dans ce chapitre).

Le programme utilisateur ne décrit donc que les caractéristiques logiques du fichier, parexemple :

• longueur d'article,• format d'article (fixe ou variable),• organisation (séquentielle, relative ou séquentielle indexée),• mode d'accès,• mode d'ouverture.

Certains langages de programmation permettent de déclarer le nombre de tampons, lalongueur de bloc, etc. Sous GCOS 7, il est préférable de fournir ces informations dans leGCL ou dans le JCL, ce qui permet de changer les caractéristiques des fichiers sansavoir à modifier - et donc à recompiler - les programmes. Les valeurs spécifiées dans lelabel priment sur celles spécifiées au moyen du GCL et du JCL, lesquelles priment surcelles spécifiées dans le programme (voir paragraphe 5.10).


5-6 47 F2 04UF Rev04

5.5 GROUPE DE PARAMETRES ASG n (AFFECTATION DE FICHIERS)

Dans la commande GCL EXEC_PG, l'utilisateur demande l'affectation au programme dechaque fichier à traiter. Pour chaque fichier, il associe un groupe de paramètres ASGn(spécifiant son nom externe et éventuellement certaines options de traitement) auparamètre FILEn (désignant son nom interne).

M U P P R G

LIB = MY.LMLIB FILE1 = IFB ASG1 = FA.X:PLM:MS/D500 FILE2 = IFA ASG2 = FA.Y FILE3 = FX2 ASG3 = SYS.OUT;

EXEC_PG MUPPRG

V o lu m e d isq ueP L M

P ro g ram m e u tilisa teu r V o lu m e d isq ueP D V A

F ich ie r F ich ie r

E ta tim prim é

FA .X FA .Y

Figure 5-1. Affectation de fichiers à un programme

Le programme MUPPRG accède à deux fichiers disque : FA.X dans le volume PLM, etFA.Y dans le volume PDVA. Un état imprimé est généré par l'intermédiaire du mécanismeSYSOUT standard.

Le fichier FA.X est permanent et non catalogué ; la réservation d'espace pour ce fichier etle chargement des articles ont donc probablement eu lieu au cours d'un travail précédent.Le fichier FA.Y est soit catalogué, soit temporaire, soit résidant : son nom de volume et saclasse d'appareils n'ont donc pas à être spécifiés. Si ce fichier est catalogué, il l'a été parla commande BUILD_FILE, CREATE_FILE ou MODIFY_FILE_STATUS, à l'exécutiond'un programme ou d'un travail précédent. GCOS 7 trouvera dans le catalogue lesinformations concernant son implantation.

La figure 5-1 ne fournit qu'un exemple très simple d'utilisation des paramètres ASGn. Lasyntaxe complète de ce groupe de paramètres est donnée dans la figure 5-2.


47 F2 04UF Rev04 5-7

ACCESS =

SHARE =

LASTVOL =

END =

DEASSIGNPASSLEAVEUNLOAD

ABEND =

DEASSIGNPASSLEAVEUNLOAD

NOFIRSTNEXT

NORMAL

MONITOR

DEFER =

0

1OPTIONAL =

EOF

EOF

ONEWRITE

FIRSTVOL =

NBEFN =ALL

WRI TEREADSPREADSPWRITERECOVERYALLREAD

0 1

POOL =

EXEC_PG nom-programme FILEn = nom-fichier-interne ASGn = (nom-fichier-externe

déc-3

déc-3

déc-3

MOUNT = déc-3

Figure 5-2. Affectation de fichiers dans la commande EXEC_PG (1/2)


5-8 47 F2 04UF Rev04

0CATNOW = 1

jjjEXPDATE = aa/jjj aa/mm/jj

6250 1600

0VOLWR = 1

DENSITY =

);

Figure 5-2. Affectation de fichiers dans la commande EXEC_PG (2/2)

Pour une description complète de ces paramètres, se reporter au manuel de référence del'utilisateur IOF.

Dans le cas des fichiers catalogués, les informations minimum sont le nom de fichierinterne, désigné par le paramètre FILEn dans la commande EXEC_PG, et le nom defichier externe, désigné par le paramètre ASGn.

Pour les fichiers non catalogués, les informations minimum à fournir sont les suivantes :

• nom de fichier interne,• nom de fichier externe,• volume disque ou bande (classique ou en cartouche) contenant le fichier,• classe d'appareils.

Les deux dernières indications sont inutiles lorsque le volume est de type résidant.


47 F2 04UF Rev04 5-9

5.6 TYPES DE VOLUMES

Il existe trois types de volumes :

• les volumes résidants,• les volumes de manoeuvre,• les volumes nommément désignés.

5.6.1 Volumes résidants

Au début d'une session GCOS 7, l'opérateur peut déclarer certains volumes disque"résidants" (RESIDENT). Ces volumes restent "en ligne" pendant toute la durée de lasession. Les fichiers à implanter ou à exploiter dans ces volumes peuvent être spécifiéssans indication de nom de volume et de classe d'appareils (s'ils sont catalogués, parexemple).

COMM 'LA COMMANDE GCL SUIVANTE DEMANDE L'AFFECTATION D'UN FICHIER PRECEDEMMENT IMPLANTE DANS UN VOLUME DISQUE RESIDANT OU D''UN FICHIER CATALOGUE';

EXEC_PG MONPROGRAMME FILE1 = IFLQ ASG1 = PY.RMSX;

COMM 'LA COMMANDE GCL SUIVANTE DEMANDE L'AFFECTATION D'UN FICHIER TEMPORAIRE IMPLANTE DANS UN VOLUME DISQUE RESIDANT';

EXEC_PG MONPG FILE1 = INLBNB ASG1 = TFX.P$TEMPRY;

Figure 5-3. Utilisation de volumes résidants


5-10 47 F2 04UF Rev04

5.6.2 Volumes de manoeuvre

A la différence des volumes résidants, qui sont toujours sur disque, les volumes demanoeuvre (WORK) sont toujours sur bande (classique ou en cartouche). Leurpréparation s'effectue au moyen d'un utilitaire, par exemple, PREPARE_TAPE (PRPTP)en GCL (équivalent JCL = VOLPREP).

Lorsqu'un volume WORK est spécifié, le système, à l'exécution du travail, demande àl'opérateur de monter un volume de manoeuvre.

Pour pouvoir écrire sur une bande de manoeuvre, un programme doit savoir si le fichierest permanent (valeur implicite) ou temporaire ($TEMPRY). S'il est temporaire, la bandereste un volume de manoeuvre. S'il est permanent, elle cesse d'être un volume demanoeuvre pour devenir un volume normal, nommément désigné.

COMM 'LE PARAMETRE ASGn CI-DESSOUS SPECIFIE UN FICHIER TEMPORAIRE SUR BANDE DE MANOEUVRE. APRES EXECUTION DU PROGRAMME, LA BANDE GARDERA L'ATTRIBUT WORK';

EXEC_PG MONPROGRAMME FILE1 = INITX ASG1 =(FIT.PM:WORK:MT/T9$TEMPRY);

COMM 'LA COMMANDE SUIVANTE SPECIFIE UN NOUVEAU FICHIER PERMANENT A IMPLANTER SUR BANDE DE MANOEUVRE';

EXEC_PG MONPG FILE1 = INQLP ASG1 = (FIT.PM:WORK:MT/T9 EXPDATE=240);

COMM 'A NOTER QUE DANS CES DEUX COMMANDES, LES PARAMETRES ASGn SPECIFIENT LE MEME NOM DE FICHIER FIT.PM. GCOS 7 L'ACCEPTE, CAR LES DEUX FICHIERS ONT UN STATUT DIFFERENT (TEMPORAIRE NON CATALOGUE ET PERMANENT NON CATALOGUE). LA PROCHAINE FOIS QUE LE FICHIER PERMANENT FIT.PM SERA UTILISE, UN NOM DE VOLUME (CELUI DE LA BANDE DE MANOEUVRE, FIGURANT DANS LE JOR) DEVRA ETRE SPECIFIE';

Figure 5-4. Utilisation de volumes de manoeuvre

Il est également possible d'utiliser des bandes de manoeuvre pour poursuivre letraitement lorsqu'un fichier bande dépasse le nombre de volumes prévu (voir plus loin"Fichiers multivolumes").


47 F2 04UF Rev04 5-11

5.6.3 Volumes nommément désignés

C'est le type de volume le plus couramment utilisé. Chaque volume disque ou bandestandard a un nom, figurant dans son label. Ce nom est défini au moyen des commandessuivantes :

PREPARE_DISK (PRPD) pour les disques,

PREPARE_TAPE (PRPTP) pour les bandes.

Une description détaillée de ces commandes est fournie dans le manuel de référence del'utilisateur IOF.

En JCL, la préparation des volumes disque et bande s'effectue au moyen de l'utilitaireVOLPREP.

COMM 'LES TROIS GROUPES DE PARAMETRES ASGn CI-DESSOUS SPECIFIENT DES FICHIERS NON CATALOGUES IMPLANTES DANS DES VOLUMES NOMMEMENT DESIGNES';

EXEC_PG MONPROG FILE1 = BINB ASG1 = LM.PL:BD41:MS/D500 FILE2 = BINC ASG2 = GHAC:1487D:MT/T9$TEMPRY FILE3 = FRED ASG3 = XA.BPLQ:TXAMB:MT/T9;

COMM 'A NOTER QUE LES VOLUMES NOMMEMENT DESIGNES PEUVENT CONTENIR DES FICHIERS TEMPORAIRES OU PERMANENTS. MAIS EN GENERAL, LES FICHIERS BANDE TEMPORAIRES SONT IMPLANTES DANS DES VOLUMES DE MANOEUVRE';

Figure 5-5. Utilisation de volumes nommément désignés


5-12 47 F2 04UF Rev04

5.7 FICHIERS MULTIVOLUMES

Un fichier peut s'étendre sur plusieurs volumes. Dans ce cas, ceux-ci doivent être dumême type (c'est-à-dire soit tous des disques de même classe, soit tous des bandes demême nombre de pistes). Pour plus de précisions sur les fichiers multivolumes et leurutilisation suivant le type d'ouverture, voir chapitre 2.

L'utilisateur doit déclarer les noms de volumes (paramètres ASGn) dans le même ordreque lors de la réservation d'espace (fichiers disque) ou de l'enregistrement initial (fichiersbande).

Le nombre maximal de volumes autorisé pour un fichier non catalogué est de 10.

COMM 'LA COMMANDE SUIVANTE SPECIFIE UN FICHIER DISQUE MULTIVOLUME NOMME MST.PLN';

EXEC_PG MONPG FILE1 = FILA ASG1 = (MST.PLN:11451/11452/11453:MS/D500);

COMM 'LA COMMANDE SUIVANTE SPECIFIE UN FICHIER BANDE MULTIVOLUME A IMPLANTER SUR BANDES DE MANOEUVRE';

EXEC_PG MONPROG FILE1 = FILB ASG1 = (N.MSTPLN:WORK:MT/T9 EXPDATE = 340);

COMM 'EXPDATE GARANTIT AU FICHIER UNE DUREE DE VIE DE 340 JOURS';

Figure 5-6. Utilisation d'un fichier disque ou bande multivolume non catalogué

La figure suivante reprend l'exemple précédent, mais avec un fichier disque catalogué.

EXEC_PG MONPROGRAMME FILE1 = FILA ASG1 = MST.PLN;

Figure 5-7. Utilisation d'un fichier multivolume catalogué

Un fichier multivolume peut être temporaire ou permanent.Lorsque le fichier est spécifié sur support de manoeuvre (WORK), le système utiliseautomatiquement autant de volumes de manoeuvre que nécessaire. L'ordre de leurutilisation apparaîtra dans l'historique du travail (JOR) et les noms de ces volumesdevront être réemployés dans toute référence ultérieure au fichier (si celui-ci n'est pastemporaire).Avec les fichiers multibandes ouverts en mode OUTPUT ou EXTEND, si l'utilisateur aprévu un nombre insuffisant de volumes, il est possible d'employer des bandes demanoeuvre supplémentaires. Dans ce cas, lorsque le système a atteint la fin de bande dudernier volume spécifié, il demande à l'opérateur de monter un volume de manoeuvre.L'opérateur peut refuser, auquel cas le travail est arrêté prématurément.


47 F2 04UF Rev04 5-13

5.7.1 Traitement partiel et extension du nombre de volumes

Ces possibilités ne sont applicables qu'aux fichiers multivolumes bande (classique ou encartouche) et disque à organisation séquentielle.Pour effectuer un traitement partiel (ne portant que sur certains volumes du fichier),l'utilisateur peut sélectionner les volumes utiles lors de l'affectation au traitement, ce quipermet une économie importante au niveau des lectures.De même, pour ménager une extension éventuelle sur d'autres volumes (cas d'uneouverture en mode EXTEND), il peut spécifier une liste de volumes commençant à celuiqui contient la fin de fichier. Dans le cas des disques, le premier volume de la liste doitêtre le premier du fichier pour pouvoir disposer du label étendu.Dans le cas d'un fichier UFAS-EXTENDED sur disque, le premier volume doit toujoursêtre monté, car il contient l'espace adresses 1.

P M 5

L B A L B B LB C LB D L B E

P M 2 P M 3 P M 4 P M 6

148 ?

P M 1

Fichier FNAL.A

Fichier HM QC.41

Le fich ie r tien t ac tue llem en t dans le seu l vo lum e 148 . S 'il est o uve rt en m o de E XT EN D ,les ad jon ction s pou rron t é ven tue llem en t se pou rsu iv re da ns un ou p lus ieurs vo lum esde m anoeuvre .

S i les fich ie rs FN AL .A , H M Q C .41 e t N C U .BX son t ca ta lo gu és , la p ro gram m ation d esexem ple s donnés ic i se ra la su ivante :

EXEC_PG MONPROG LIB = MY.LIB:MSD:MS/D500 FILE1 = FLA ASG1 = (FNAL.A FIRSTVOL = 3 LASTVOL = 4)

FILE2 = FLB ASG2 = (HMQC.41 FIRSTVOL = 4)

FILE3 = FLC ASG3 = NCU.BX;

L e p rog ra m m e lit un iquem e nt les a rtic le s e n reg is trés d an s le s vo lu m es LB C e t L BD .Les vo lu m es LB A , LBB e t LB E ne son t pa s u tilisés .

Fichier NCU .BX

P M 4 es t le v o lu m e con te n a n t a ctue lle m e n t la fin d e fich ie r. S i l'o u ve rtu re s 'e ffec tu e e nm od e E X TE N D , le s ad jon ctio ns c om m e nce ro n t d a n s ce vo lu m e e t se p ou rsu ivro n té ve n tue llem en t da n s le s v o lu m e s ré se rvés P M 5 , p u is P M 6 .

Figure 5-8. Traitement partiel/extension de fichiers bande multivolumes


5-14 47 F2 04UF Rev04

5.7.2 Gestion du nombre d'appareils mobilisés (paramètre MOUNT)

Cette possibilité n'est applicable qu'aux fichiers multivolumes bande (classique ou encartouche) et disque à organisation séquentielle.

Fichiers disque :

Dans les exemples fournis jusqu'ici, pour chaque fichier considéré, tous les volumesdevaient être "en ligne" simultanément et un groupe de paramètres ASGn spécifiant cinqvolumes nécessitait donc cinq unités de disques.

Il est possible de réduire le nombre de disques mobilisés en utilisant le paramètreMOUNT du groupe ASGn. Pour les disques "non fixes", ce paramètre permet de spécifierle nombre maximal de volumes montables simultanément pour un fichier (séquentieluniquement). Sa valeur implicite pour les disques étant le nombre total de volumes dufichier, sa logique d'utilisation est la réduction du nombre d'appareils.

Fichiers bande :

Inversement, pour les bandes, la logique d'utilisation du paramètre MOUNT estl'augmentation du nombre d'appareils. Sa valeur implicite est 1 (un seul volume montablesimultanément, donc un seul dérouleur mobilisé). Cette option a l'inconvénientd'interrompre le déroulement du programme chaque fois que le traitement doit passer auvolume suivant (sauf si celui-ci a été monté à l'avance sur un autre appareil). Sil'utilisateur spécifie MOUNT = 2 (valeur la plus couramment employée avec la valeurimplicite), deux dérouleurs sont mobilisés. L'opérateur peut ainsi monter les deux volumesà l'avance et le passage de l'un à l'autre s'effectue sans son intervention (voir figure 5-9).


47 F2 04UF Rev04 5-15

MA1 MA2 MA3 MA4

MA1 MA2 MA3 MA4

MA1 MA2 MA3 MA4

M T 01 M T0 2 M T01 M T 02

M T 01 M T0 1 M T0 1 M T 01

M T 01 M T 02 M T03 M T 04

EXEC_PG MONPROGRAMME FILE1 = GLBE ASG1 = (REL.X MOUNT = 4);

U tilisa tion d equ a tre dé ro u leu rs

U tilisa tion d 'unseu l dé rou leu r

EXEC_PG MONPG FILE1 = GLBE ASG1 = (REL.X MOUNT = 1);

EXEC_PG PROGRAMME FILE1 = GLBE ASG1 = (REL.X MOUNT = 2);

U tilisa tion d ede ux d é rou le u rs

COMM 'UTILISATION DU MAXIMUM DE PERIPHERIQUES';

COMM 'UTILISATION DU MINIMUM DE PERIPHERIQUES';

COMM 'MONTAGE A L'AVANCE PAR L'OPERATEUR';

Figure 5-9. Gestion des périphériques pour le traitement des fichiers multivolumes

Le paramètre MOUNT peut s'appliquer aux fichiers bande permanents (catalogués ounon) et temporaires (voir chapitre 7, paragraphe 7.2).

Si l'utilisateur spécifie WORK pour un fichier multivolume, le système considère queMOUNT = 1.

La valeur de MOUNT reste effective lorsque le traitement d'un fichier se poursuit avec desvolumes de manoeuvre.


5-16 47 F2 04UF Rev04

5.8 POOLS D'APPAREILS (PARAMETRES POOL)

Nous venons de voir que le paramètre MOUNT permet de moduler le nombre d'appareilsmobilisables pour un fichier multivolume. Une autre forme de gestion des périphériquesconsiste à partager des appareils entre plusieurs fichiers.

Dans les exemples présentés jusqu'ici, tous les fichiers cités par les paramètres ASGndevaient être "en ligne" en début d'exécution du programme. Ainsi, dans l'exemple de lafigure 5-8, six dérouleurs devaient être disponibles en même temps. Pourtant, si letraitement du fichier FNAL.A est complètement terminé au moment où commence celuidu fichier HMQC.41, il devient possible d'utiliser les mêmes dérouleurs pour les deuxfichiers.

Pour ce faire, il suffit de définir un pool d'appareils au moyen du paramètre POOL de lacommande EXEC_G et du paramètre POOL du groupe ASGn. Ces paramètres sontdécrits dans le volume 2 du manuel de référence de l'utilisateur IOF (22UJ/23UJ).

Le fonctionnement du pool dépend de la logique du programme. Lorsqu'il a terminé letraitement d'un fichier, celui-ci doit signaler à GCOS 7 que le fichier peut être libéré, lesappareils utilisés redevenant disponibles. (En COBOL, option WITH LOCK dansl'instruction CLOSE).

Dans la figure ci-dessous, le programme SLICK utilise trois fichiers disque : DF.A, DF.Bet DF.C. Le traitement de DF.A doit être entièrement terminé avant que celui de DF.Cpuisse commencer.

E X 5 8

D F .C

B D 18

D F .B

B D 1 4

D F .A

S LIC K

OPEN FDFA, FDFB...CLOSE FDFA WITH LOCKOPEN FDFC...CLOSE FDFB, FDFC

EXEC_PG SLICK LIB = AX.LIB POOL = 1*MS/D500 FILE1 = FDFA ASG1 = (DF.A POOL = FIRST) FILE2 = FDFA ASG2 = DF.B FILE3 = FDFC ASG3 = (DF.C POOL = NEXT);

Figure 5-10. Mise en oeuvre d'un pool d'appareils


47 F2 04UF Rev04 5-17

La figure 5-10 illustre la mise en oeuvre d'un pool constitué d'une seule unité de disquesMS/D500. Deux fichiers, DF.A et DF.C, utiliseront successivement cette unité (présencedu paramètre POOL dans ASG1 et ASG3). Au lancement du programme, seul DF.A(désigné comme étant le premier par le paramètre FIRST) sera monté. DF.C ne seramonté qu'au moment de son ouverture par le programme, lorsque l'unité de disquesdeviendra disponible. Ainsi, le programme SLICK utilise seulement deux unités dedisques pour traiter trois fichiers.

A noter que l'unité de disques utilisée pour le fichier DF.B ne fait pas partie du pool(absence du paramètre POOL dans ASG2).

Un programme n'admet qu'un seul pool par type d'appareils.

Dans cet exemple, le pool est constitué d'une seule unité de disques, mais un poolcomporte généralement plusieurs appareils. Si l'un au moins des deux fichiers DF.A etDF.C occupait deux volumes, le paramètre POOL de la commande EXEC_PG devraitêtre spécifié comme suit :

POOL 2*MS/D500

Les disques ou les bandes constituant le pool sont nécessairement du même type. Lesfichiers peuvent être temporaires ou permanents. Le paramètre MOUNT est utilisablesans restrictions.


5-18 47 F2 04UF Rev04

5.9 PARTAGE DE FICHIER (PARAMETRE SHARE)

Le partage de fichier permet à plusieurs programmes d'accéder concurremment aumême fichier. Cette possibilité s'applique uniquement aux fichiers disque.

C'est le paramètre SHARE qui spécifie le mode de partage d'un fichier. Il définit le niveaumaximal autorisé pour la concurrence d'accès.

Pour les fichiers catalogués, il suffit de spécifier le mode d'accès (ACCESS), car le modede partage (SHARE) fait partie des attributs du fichier enregistrés dans le catalogue.

La figure 5-11 illustre le cas de partage d'un même fichier par deux activités différentes :

EXEC_PG MONPG1

FILE1 = IFA ASG1 = (XP.ML SHARE = NORMAL ACCESS = READ)...;

EXEC_PG MONPG2

FILE1 = MX ASG1 = (XP.ML SHARE = NORMAL ACCESS = READ)...;

Figure 5-11. Partage d'un fichier par deux activités

Les deux noms de fichier internes (IFA et MX) sont associés au même nom de fichierexterne (XP.ML).

Le fichier XP.ML sera accessible par le programme MONPG1 sous le nom IFA et par leprogramme MONPG2 sous le nom MX.

Les différents modes de partage sont les suivants :

SHARE = NORMAL (valeur implicite) Plusieurs utilisateurs en lecture ou unseul utilisateur en écriture par fichier. Le verrouillages'effectue au niveau fichier.

SHARE = ONEWRITE Plusieurs utilisateurs en lecture et un seul utilisateur enécriture par fichier. Le verrouillage s'effectue au niveaufichier.

ATTENTION :

Ne pas utiliser SHARE = FREE (plusieurs utilisateurs en lecture et enécriture sans aucun contrôle).

A noter qu'à l'affectation d'un fichier catalogué, si l'utilisateur spécifie SHARE avec unevaleur différente de celle figurant dans le catalogue, c'est la valeur du catalogue quiprévaut et le programme aura l'accès exclusif au fichier (ACCESS = READ devientACCESS = SPREAD, et ACCESS = WRITE devient ACCESS = SPWRITE).

Pour assurer l'accès exclusif à un fichier, il est cependant préférable de spécifierACCESS = SPREAD ou ACCESS = SPWRITE, selon le cas, quelle que soit la valeur deSHARE.

La figure 5-12 indique les types de partage possibles avec SHARE = NORMAL etSHARE = ONEWRITE.


47 F2 04UF Rev04 5-19

A C C E S S

W R IT E

S P W R IT E

R E A D

S P R E A D

R E A D

S P R E A D

W R IT E

S P W R IT E

S H A R E

Va leu rs d e s p aram ètres

Usage exclusif (valeur implicite).

Usage exclusif.

Lecture en concurrence avec d'autres utilisateurs en lecture.

Lecture exclusive.

Lecture en concurrence avec d'autres utilisateurs en lecture et un seul utilisateur en écriture.

Lecture exclusive.

Ecriture en concurrence avec d'autres utilisateurs en lecture.

Usage exclusif.

T ype de pa rtage dem an dé

N O R M A L

N O R M A L

N O R M A L

N O R M A L

O N E W R IT E

O N E W R IT E

O N E W R IT E

O N E W R IT E

Figure 5-12. Combinaisons SHARE/ACCESS

La figure 5-13 ci-après récapitule les différents types de partage pouvant être demandéspar l'utilisateur. La demande peut être acceptée ou refusée, selon le type de partageactuel du fichier. Par exemple :

un fichier affecté avec les valeurs

ACCESS = READ et SHARE = ONEWRITE

peut être partagé avec un autre travail spécifiant les valeurs

ACCESS = WRITE et SHARE = ONEWRITE

Le type de partage (SHARE + ACCESS) est indépendant de l'organisation de fichier.

L'utilisateur doit observer les règles suivantes :

• Un fichier ouvert en mode OUTPUT ne peut pas être partagé (puisque ce modecorrespond à la phase de chargement initial).

• Les fichiers séquentiels indexés peuvent être partagés en mode ONEWRITE.

Remarque importante :

Pendant les réorganisations incrémentales de CI, il n'y a plus verrouillage de la totalitédu fichier comme c'était le cas sous UFAS, ce qui tend à réduire le nombre des conflitsd'accès. Le fichier reste accessible en lecture par plusieurs utilisateurs.


5-20 47 F2 04UF Rev04

Affectation/partage d'un fichier avec END = PASS

Lorsqu'un fichier a été affecté à un premier travail avec l'option END = PASS, il n'est paspossible de l'affecter à un second travail avec END = PASS tant qu'il n'a pas été libéré parle premier travail. Cette restriction évite les blocages de traitement (deadlocks).

W R ITE /N O R M AL

SP W R IT E /N O R M A L

R EAD /N O R M AL

S PR EAD /N O R M AL

R EAD/O N EW RIT E

SPR EAD /O N EW RIT E

W R IT E /O N EW R IT E

SP W RIT E /O N EW R IT E

R EADN O R M AL

S PR EA D *N O R M AL

R EADN O R M AL


S PR E A D *N O R M A L




R EADN O R M AL


R EADO N EW RIT E




SP R EAD *O N EW R IT E

W R IT EO N EW R IT E

SPW RITE *O N EW RIT E

W RIT EO N EW RIT E

SPW RITE *O N EW R IT E



WRITE/NORMAL

SPW RITE /N O R M AL

R E AD /N O R M AL

SP R E AD /N O R M A L

R E A D/O N E W R IT E

W R IT E /O N EW R ITE

SPW R ITE /O N EW R IT E

SPR E AD /O N EW R IT E

SPR EAD *O N EW R IT E

Type d'accès/de

partage actuel

T yp e d 'accès /de pa rta ge dem andé

SPW R ITE *O N EW R IT E

SPW R ITE *O N EW R IT E

Figure 5-13. Règles de partage d'un fichier

Les cases vides indiquent que le partage est refusé. Les astérisques signifient qu'il n'estautorisé qu'à l'intérieur de la même activité.


47 F2 04UF Rev04 5-21

5.10 REGLES DE RECOUVREMENT DES VALEURS DE PARAMETRES

AVERTISSEMENT

L'utilisateur doit, dans la mesure du possible, veiller à la cohérencedes valeurs qu'il spécifie. Certains contrôles sont cependant assurés :par exemple, un contrôle est prévu à l'ouverture du fichier pour vérifierque la longueur d'article est identique à celle déclarée dans leprogramme. En COBOL 85, d'autres contrôles ont lieu, et touteincohérence entre programme et fichier provoque un arrêt prématuréavec envoi du code retour OVRVIOL.

Lorsqu'un programme ouvre un fichier, UFAS-EXTENDED doit disposer d'un minimumd'informations pour le traitement. Des attributs tels que taille de CI (taille de bloc pour lesfichiers bande), longueur et format des articles, nombre de tampons, par exemple,doivent donc être déclarés explicitement, ou fournis implicitement.

Les informations nécessaires peuvent provenir de plusieurs sources :

• Le label du fichier, s'il est déjà créé.

Pour un fichier disque existant ou un fichier bande d'entrée, les valeurs spécifiées dansle label priment sur celles spécifiées dans le programme et sur celles spécifiées aumoyen du GCL ou du JCL.

Il n'y a pas d'informations label dans les cas suivants :

- fichier bande de sortie (voir chapitre 7, paragraphe 7.7) ;

- fichier disque à créer dynamiquement au moyen du groupe de paramètres ALCn(voir chapitre 6).

• Le groupe de paramètres d'affectation de place ALCn (équivalent JCL = ALLOCATE)et le groupe de paramètres de définition de fichiers DEFn (équivalent JCL = DEFINE),qui peuvent être associés à un groupe de paramètres ASGn (équivalent JCL =ASSIGN).

Les valeurs déclarées dans le GCL ou le JCL (par exemple, nombre de tampons ouCISIZE) priment sur celles du programme. Le groupe de paramètres DEFn est décritplus loin dans ce chapitre et au chapitre 6 (paragraphe 6.8.4).

• Les attributs fournis par le programme utilisateur (généralement implicites).


5-22 47 F2 04UF Rev04

Les règles générales de recouvrement des valeurs de paramètres de définition de fichierssont les suivantes :

Règles 1 :

Ces règles s'appliquent si le fichier existe déjà. Voir avertissement plus haut.

1. Label du fichier (et VTOC pour les fichiers disque).

2. Catalogue (pour les fichiers catalogués).

3. Paramètres de définition de fichier (GCL ou JCL).

4. Valeur déterminée par une commande (par exemple, valeur figurant dans la FD d'unprogramme COBOL si la commande EXEC_PG est utilisée ou valeur implicite pourun utilitaire).

1. prévaut sur 2., qui prévaut sur 3., qui prévaut sur 4. Voir avertissement plus haut.

Règles 2 :

Ces règles s'appliquent si le fichier n'existe pas encore (fichier à créer dynamiquement aumoyen du groupe de paramètres ALCn en GCL ou de l'ordre ALLOCATE en JCL).

1. Paramètres de définition de fichier (GCL ou JCL).

2. Attribut implicite du fichier (fourni automatiquement par le programme COBOL oupar un utilitaire).

3. Valeur déterminée par une commande (voir règles n°1).

1. prévaut sur 2., qui prévaut sur 3. Voir avertissement plus haut.

Les paramètres du groupe DEFn (équivalent JCL = DEFINE) n'ont pas de valeur implicite.Si l'utilisateur ne fournit pas de valeur pour l'un de ces paramètres, elle lui seraautomatiquement attribuée en fonction des deux règles énoncées ci-dessus ; parexemple :

• CISIZE sera forcé à 2048 octets (3584 pour les unités de disques MS/D500 et MS/B10si les commandes CREATE_FILE ou CREATE_FILESET sont utilisées).

• CIFSP sera forcé à 0.

Le paramètre FPARAM permet d'indiquer si les valeurs de paramètres de définitionfournies par l'utilisateur doivent primer sur celles figurant dans le label du fichier.

• Si FPARAM = 0 (valeur implicite), ce sont les valeurs du label de fichier qui priment(dans le cas d'un fichier existant).

• Si FPARAM = 1, ce sont les valeurs des paramètres de définition qui priment (dans lecas d'un fichier existant). Cette option n'est à utiliser que dans certains cas particuliers :par exemple, lorsque le fichier n'est pas standard, et/ou lorsqu'il est à rechargerconformément aux paramètres de définition spécifiés.

• Dans le cas de fichiers catalogués, FPARAM ne peut pas être utilisé pour imposer desvaleurs différentes de celles figurant dans le catalogue.


47 F2 04UF Rev04 5-23

5.11 GROUPE DE PARAMETRES DEFn (DEFINITION DE FICHIERS)

Comme indiqué plus haut, les attributs de fichier définis dans le catalogue priment surceux définis au moyen du groupe de paramètres DEFn. Il est donc préférable - dans lamesure du possible - de définir ces attributs dans le catalogue.

Si le groupe de paramètres de définition de fichiers DEFn (équivalent JCL = DEFINE) estprésent dans la commande EXEC_PG, il est associé à un paramètre FILEn (nom defichier interne) et à un groupe de paramètres d'affectation de fichiers ASGn (équivalentJCL = ASSIGN).

EXEC_PG MONPROGRAMME FILE1 = TFX ASG1 = JC.JHB ... DEF1 = (paramètres-définition-fichier);

Le groupe de paramètres DEFn permet de :

• spécifier certains paramètres d'exécution valables uniquement pour la durée duprogramme consideré (par exemple, nombre de tampons) ;

• décrire les attributs du fichier dans les trois cas suivants :

- fichier disque à créer dynamiquement (présence du groupe de paramètresd'affectation de place ALCn),

- fichier bande de sortie,- fichier bande d'entrée sans label ;

• traiter les fichiers bande non standard.

Voir ci-après le groupe de paramètres DEFn applicable aux tampons (syntaxe complèteau paragraphe 6.8.4). A noter qu'il est fortement recommandé de spécifier le type dejournalisation dans le catalogue, au lieu d'utiliser DEFn.

EXEC_PG MONPG FILEn = nom-de-fichier-interne ASGn = nom-de-fichier-externe DEFn = ( [BUFPOOL = nom-4] [NBBUF = déc-3] )

Les paramètres du groupe DEFn n'ont pas de valeur implicite. Les valeurs spécifiées pources paramètres s'ajoutent à celles déclarées dans le programme ou s'y substituent (voirparagraphe 5.10).

Pour une description complète de ce groupe de paramètres, se reporter au manuel deréférence de l'utilisateur IOF et au manuel de référence JCL.


5-24 47 F2 04UF Rev04

5.12 GESTION DES TAMPONS

Ce paragraphe doit permettre à l'utilisateur de mieux comprendre la mise en oeuvre destampons lors de l'exécution d'un programme. Le mécanisme d'accès aux tampons esttransparent pour l'utilisateur : tout se passe au niveau d'UFAS-EXTENDED et d'autresmodules logiciels avec lesquels ce système coopère, comme le gestionnaire de mémoirevirtuelle (VMM).

L'utilisation de tampons, qui permet de travailler avec d'importantes quantités de donnéesen mémoire principale, a pour but de minimiser le nombre d'accès disque.

Les tampons sont des zones de mémoire où sont chargés les CI (disque) ou les blocs(bande) contenant les articles à traiter (en lecture ou en écriture). Tant que les articles àtraiter sont dans un tampon, les instructions READ et WRITE du programme COBOLn'impliquent pas d'opérations d'E/S sur le fichier, d'où un gain de temps important.

En GCL, les paramètres de gestion des tampons pour l'exécution d'un programme sontles suivants :

POOLSIZE dans la commande EXEC_PG demandant l'exécution duprogramme (en JCL, ce paramètre figure dans l'ordreSIZE).

BUFPOOL dans le groupe de paramètres de définition de fichiersDEFn (équivalent JCL = DEFINE).

NBBUF dans le groupe de paramètres de définition de fichiersDEFn (équivalent JCL = DEFINE).

EXEC_PG MONPROG } [SIZE = déc8] } au niveau programme [POOLSIZE = déc8]... }

FILE1 = NFI1 } au ASG1 = NFE1 } niveau DEF1 = ([BUFPOOL = nom-4 NBBUF = déc3]) } fichier FILE2 = NFI2 } ASG2 = NFE2 } DEF2 = ([BUFPOOL = nom4 NBBUF = déc3]...); }

Désormais, de même que les applications TDS, les applications traitement par lotsimportantes peuvent utiliser des pools de tampons de grande taille (voir exemples auparagraphe 5.12.4 pour plus de détails).

Les paragraphes suivants décrivent l'utilisation des tampons dans les applicationstransactionnelles, traitement par lots et IOF.


47 F2 04UF Rev04 5-25

.

.

.

.

4 0 0 0

.

.

.

.

.

.

.

P O O L S IZE (m ax. 2 0.000 tam p o ns )

S e g m e n tsde do n né e s

S tru ctu rein te rn ee tc .

P oo l de tam p o ns (n o m T D S )

P seud o -po o l(D E F T )

P ool de tam ponsB U FPO O L = nom

S eg m e n tsde c od e

Figure 5-14. Structure de la mémoire tampon

A noter que c'est l'attribut ICA (isolation des activités) qui permet de garantir à l'activitéune quantité de mémoire suffisante pour s'exécuter dans la dimension. L'option MINMEMde l'ordre JCL SIZE ne doit plus être utilisée.

Le paramètre POOLSIZE de l'ordre JCL SIZE spécifie la taille maximale de l'espacemémoire à réserver aux pools de tampons, à savoir :

• un pseudo-pool nommé DEFT (dont les tampons ne sont pas partageables par lesfichiers) ;

• un pool "réel", portant le nom de l'application TDS ;• le cas échéant, un pool de tampons non-TDS, portant le nom défini par le paramètre

BUFPOOL de l'ordre JCL DEFINE.

A noter que le nombre de tampons est limité à 20.000 par travail. Pour une applicationTDS, la clause RESERVE AREAS spécifie ces tampons dans le pool principal ; pour uneapplication IOF ou traitement par lots, le paramètre NBBUF de l'ordre JCL DEFINEpermet de les spécifier dans d'autres pools. Le nombre de tampons par pool doitcorrespondre au total des valeurs de NBBUF pour tous les fichiers du pool.

Le pseudo-pool représenté en pointillé à la figure 5-15 comporte cinq tampons.


5-26 47 F2 04UF Rev04

5.12.1 Paramètre POOLSIZE

Ce paramètre spécifie (en Koctets) la taille maximale de l'espace mémoire à réserver auxtampons. C'est cet espace qu'UFAS-EXTENDED utilisera pour créer et manipuler destampons. Il est recommandé de spécifier pour POOLSIZE une valeur bien supérieure àsa valeur implicite (27 Ko).

La valeur de POOLSIZE doit être de préférence un multiple de 4 Ko.

Si l'application utilise plusieurs pools de tampons (voir plus loin), POOLSIZE indique lataille mémoire à réserver pour tous les pools.

APPLICATIONS TDS :

Pour les applications TDS, il faut prévoir de réserver de l'espace mémoire pour tous lespools de tampons, y compris le pseudo-pool DEFT, en procédant comme suit :

1. Selon le modèle de DPS 7000, la quantité de mémoire à réserver aux tamponsreprésente 20 à 50 % (parfois plus) de l'espace mémoire total.2. Répartir la mémoiretampon entre les différentes applications TDS, en tenant compte de facteurs tels quela taille de l'application, le nombre de fichiers pouvant être ouverts concurremment,etc.

3. Evaluer le nombre maximal de tampons par pool (voir paragraphe 5.12.3).

4. Adapter la taille de l'espace d'exécution déclaré (DWS).

Chaque fois que l'utilisateur augmente la taille de la mémoire tampon (POOLSIZE), ildoit veiller à accroître en conséquence la taille de l'espace d'exécution DWS. Cesdeux paramètres font partie de l'ordre JCL SIZE.

5. Adapter le nombre de tampons à la valeur de POOLSIZE (voir paragraphe 5.12.3).


47 F2 04UF Rev04 5-27

APPLICATIONS TRAITEMENT PAR LOTS ET IOF :

La formule suivante permet de calculer approximativement la valeur de POOLSIZE :

POOLSIZE = (nbpg moyen * 4 Ko) * NBBUF

nbpg étant le nombre de pages nécessaires pour un CI, c'est-à-dire :

nbpg = CISIZE arrondi au multiple supérieur de 4 Ko 4096

Si la valeur obtenue pour POOLSIZE est, par exemple, de 400 Ko, l'utilisateur peutspécifier :

EXEC_PG MONPROG SIZE = 500 POOLSIZE = 400;


5-28 47 F2 04UF Rev04

5.12.2 Paramètre BUFPOOL

Ce paramètre, lorsqu'il est présent, spécifie le nom du pool de tampons à utiliser pour unfichier.

Les fichiers associés à un même pool en partagent les tampons.

La constitution de pools permet donc de réduire l'espace mémoire global alloué auxtampons en partageant une certaine partie de cet espace entre plusieurs fichiers.

Lorsqu'UFAS-EXTENDED reçoit une demande de lecture de CI, il vérifie si ce CI estprésent dans l'un des tampons existants. Dans le cas contraire, UFAS-EXTENDEDcherche un tampon inutilisé pour y charger le contenu du CI.

L'utilisation du paramètre BUFPOOL est recommandée pour les applications utilisant denombreux fichiers en accès direct.

BUFPOOL fait partie du groupe de paramètres de définition de fichiers DEFn (équivalentJCL = DEFINE).

APPLICATIONS TDS :

Avec UFAS-EXTENDED, l'utilisation d'un pool de grande taille peut permettre uneimportante amélioration des performances du système :

• réduction du nombre d'opérations d'E/S pouvant atteindre 50 %,

• amélioration des temps de réponse.


47 F2 04UF Rev04 5-29

Chaque application TDS dispose implicitement :

• d'un pool de tampons pour tous les fichiers contrôlés par TDS (ce pool porte le nom del'application TDS) ;

• d'un pseudo-pool (DEFT) automatiquement fourni pour les fichiers non contrôlés parTDS.

Les tampons du pool DEFT présentent l'inconvénient de ne pas être partageables par lesfichiers non contrôlés par TDS (H_CTLN par exemple).

Il est généralement recommandé de se limiter à un seul pool de tampons (nom-tds) pourles applications TDS, mais de ne pas spécifier de pool pour les fichiers :

• à accès séquentiel. En effet, ces fichiers ne nécessitent que quelques tampons à la fois(2 pour les fichiers séquentiels, une dizaine pour les autres).

• à accès direct avec un petit nombre de CI. Ces fichiers doivent être regroupés dans unpool spécifique, avec un nombre de tampons égal au nombre total de CI.

Le pool principal peut être complété d'un deuxième pool, utilisable pour des fichiersd'entrée comportant des tables (exemple : nom et adresse des clients) ou lescaractéristiques des produits dans une application de gestion de stocks. Autre possibilitéd'emploi : pour les fichiers séquentiels indexés à accès séquentiel (afin d'éviter unesaturation du pool principal).

Pour chaque fichier associé à un pool, il est nécessaire de spécifier :

• le nom du pool (BUFPOOL),

• le nombre de tampons (NBBUF).


5-30 47 F2 04UF Rev04

Ces deux paramètres font partie du groupe de paramètres DEFn (équivalent JCL =DEFINE).

En cas d'omission, les valeurs implicites suivantes s'appliquent :

• BUFPOOL = nom de l'application TDS (nom-tds),

• NBBUF = nombre de tampons déclaré dans la clause "RESERVE n AREAS".

A noter que la valeur définie par "RESERVE n AREAS" correspond à l'ensemble destampons d'une application TDS.


Il est possible de définir un ou plusieurs pools, ou de n'en définir aucun, mais l'utilisationd'un pool est conseillée dès que l'on accède non séquentiellement à des activitésimpliquant cinq fichiers minimum. Ne pas spécifier de pool pour des fichiers auxquels onaccède séquentiellement, mais utiliser de préférence le mécanisme d'antémémoire LMC.A noter que l'utilisation de pools de tampons multiples est réservée à des cas spécifiques.


47 F2 04UF Rev04 5-31

5.12.3 Clause RESERVE AREAS/Paramètre NBBUF

Le paramètre NBBUF permet de définir le nombre de tampons à associer à un fichier.NBBUF fait partie du groupe de paramètres de définition de fichiers DEFn (voir plus haut),et de l'ordre JCL équivalent DEFINE.

Le nombre minimal de tampons par fichier est 1, indépendamment de l'organisation et dutype d'accès.

Les valeurs implicites de NBBUF sont les suivantes :

• NBBUF = 2 pour les fichiers en accès séquentiel.

• NBBUF = 1 pour les fichiers en accès non séquentiel.

• NBBUF = 1 pour les fichiers séquentiels indexés en accès direct. Le système réserveaussi des tampons supplémentaires pour la réorganisation incrémentale de CI.

• NBBUF = 4 pour les aires IDS/II.

Le nombre de tampons peut être défini :

• soit pour chaque fichier,• soit au niveau du pool (les tampons étant partagés par plusieurs fichiers).

Dans la mesure du possible, il est préférable d'utiliser un pool et de spécifier le mêmenombre de tampons (NBBUF) pour chacun des fichiers associés à ce pool.


5-32 47 F2 04UF Rev04

APPLICATIONS TDS :

Le nombre de tampons spécifié dans la clause RESERVE AREAS doit être choisi demanière à optimiser l'utilisation de la mémoire tampon (POOLSIZE). Le nombre maximalde tampons est de 20.000 pour une application TDS, et de 32.000 au niveau système.

Spécifier une valeur approximative, en utilisant la formule :

nombre de tampons = POOLSIZE divisé par (nb de pages * 4 Ko)

Par exemple, pour une taille de CI (CISIZE) de 6 Ko, il faut 2 pages de mémoire, carchaque page occupe 4 Ko. A noter que :

nombre de pages = CISIZE divisé par 4096 et arrondi au multiple supérieur de 4 Ko.

Il est possible d'affiner cette évaluation en se référant aux valeurs de USED SIZE etPOOLSIZE figurant dans le JOR. Si USED SIZE est inférieur à POOLSIZE, porter lenombre de tampons à la valeur maximale spécifiée dans la clause RESERVE AREAS ;sinon, diminuer la valeur de POOLSIZE et la taille de l'espace d'exécution déclaré (DWS).

Si le nombre de pools de tampons est supérieur ou égal à deux, spécifier le mêmenombre de tampons (paramètre NBBUF de l'ordre DEFINE) pour chaque fichier associé àun même pool (voir deuxième exemple TDS plus loin dans ce chapitre).


Chaque fichier dispose implicitement d'un ou de deux tampons, de manière à respecter lacondition suivante :

POOLSIZE => (nb. de pages * nb. de tampons)

Si les valeurs implicites ne conviennent pas, utiliser le paramètre NBBUF du groupe deparamètres DEFn (équivalent JCL = DEFINE) pour les remplacer.

En règle générale, le nombre de tampons par fichier (NBBUF) ne doit pas être inférieurà 6 auquel on ajoute le nombre d'index secondaires. L'application de cette règle - au lieud'utiliser le nombre habituel de 100 tampons pour 3 fichiers à accès séquentiel et àplusieurs index secondaires - permet d'accroître sensiblement les performances dusystème.

Dans les premiers exemples IOF et traitement par lots (voir ci-après), le nombre detampons est spécifié pour chaque fichier au moyen du paramètre NBBUF.


47 F2 04UF Rev04 5-33

5.12.4 Exemples d'utilisation des tampons

Premier exemple TDS

Cet exemple comporte un seul pool, portant le nom de l'application TDS (à savoir TSIC).

Soit un nombre de tampons égal à 1000 (défini dans la clause "RESERVE n AREAS").

$JOB TDS-EX USER=BULL1;$JOBLIB SM,TSIC.SMLIB;STEP TSIC,FILE=(TSIC.LMLIB),REPEATDUMP=NO;SIZE 4500 POOLSIZE=4000;ASSIGN IFN1 EFN1;ASSIGN IFN2 EFN2;ASSIGN IFN3 EFN3;ASSIGN IFN4 EFN4;ASSIGN IFN5 EFN5;ASSIGN IFN6 EFN6;ASSIGN IFN7 EFN7;ASSIGN IFN8 EFN8;ASSIGN IFN9 EFN9;ASSIGN IFN10 EFN10;..............................................................................................................ASSIGN IFN50 EFN50;ASSIGN IFN51 EFN51;..............................................................................................................ASSIGN IFN70 EFN70;ASG DBUGFILE,TSIC.DEBUG,FILESTAT=CAT,SHARE=DIR;ASG BLIB,.FORM.BIN,SHARE=DIR,ACCESS=READ;$ASG H_BJRNL DVC=MS/D500 MD=FSD99 FILESTAT=TEMPRY;ASG H_FORM,.FORM.OBJET,FILESTAT=CATSHARE=MONITOR,ACCESS=READ;$DEFINE H_CTLM ,JOURNAL=BEFORE;ENDSTEP;$ENDJOB;

La taille de tampon moyenne est estimée à 3584 octets. Si POOLSIZE = 4000 Ko, lenombre de tampons nécessaire est de :

4000 Ko divisé par 4 Ko = 1000 tampons

Remarque : La valeur de POOLSIZE comprend l'espace tampon réservé auxfichiers non contrôlés par TDS.


5-34 47 F2 04UF Rev04

Deuxième exemple TDS

Cet exemple comporte, en plus du pool principal TSIC, un deuxième pool - PARA -partagé par deux fichiers.

Soit un nombre de tampons égal à 1000 (défini dans la clause "RESERVE n AREAS").

$JOB TDS-EX USER=BULL2;$JOBLIB SM,TSIC.SMLIB,TSIC.TEST;STEP TSIC,FILE=(TSIC.LMLIB),REPEATDUMP=NO;SIZE 5000 POOLSIZE=4400;ASSIGN IFN1 PARAM1;ASSIGN IFN1 NBBUF=100 BUFPOOL=PARA;ASSIGN IFN2 PARAM2;ASSIGN IFN2 NBBUF=100 BUFPOOL=PARA;ASSIGN IFN4 EFN4;ASSIGN IFN5 EFN5;ASSIGN IFN6 EFN6;ASSIGN IFN7 EFN7;ASSIGN IFN8 EFN8;ASSIGN IFN9 EFN9;ASSIGN IFN10 EFN10;..............................................................................................................ASSIGN IFN50 EFN50;ASSIGN IFN51 EFN51;..............................................................................................................ASSIGN IFN70 EFN70;ASG DBUGFILE,TSIC.DEBUG,FILESTAT=CAT,SHARE=DIR;ASG BLIB,.FORM.BIN,SHARE=DIR,ACCESS=READ;$ASG H_BJRNL DVC=MS/D500 MD=FSD99 FILESTAT=TEMPRY;ASG H_FORM,.FORM.OBJET,FILESTAT=CATSHARE=MONITOR,ACCESS=READ;$DEFINE H_CTLM ,JOURNAL=BEFORE;$DEFINE H_CTLN ,BUFPOOL=TSIC;ENDSTEP;$ENDJOB;

On évalue à 3584 octets la taille de tampon moyenne du pool implicite (TSIC).

Les deux fichiers du pool PARA disposent de 100 tampons au total (pour une taille de CIde 2048 octets). Le contenu de ces deux fichiers réside en mémoire, car le pool estsuffisamment grand pour contenir les 100 tampons.

La taille maximale de la mémoire tampon (POOLSIZE) est de 4400 Ko. Il faut déduire decette valeur 400 Ko pour les fichiers PARAM1 et PARAM2, qui disposent de 100 tamponsdans le pool PARA (les 400 Ko s'obtiennent en multipliant 100 par 4 Ko).

Les 4000 Ko restants correspondent au pool TSIC. Le nombre de tampons se calculecomme suit :

4000 Ko divisé par 4 Ko = 1000 tampons

A noter que le fichier H_CTLN (non contrôlé par TDS) est rattaché au pool principal TSIC(DEFINE H_CTLN BUFPOOL = TSIC).


47 F2 04UF Rev04 5-35

Premier exemple IOF

Cet exemple ne comporte pas de pool.

EXEC_PG PG=LMNAME LIB=.LMLIBSIZE 1700 POOLSIZE=1320FILE1=IFN1 ASG1=EFN1DEF1=(IFN1 NBBUF=200)FILE2=IFN2 ASG2=EFN2DEF2=(IFN2 NBBUF=30)FILE3=IFN3 ASG3=EFN3DEF3=(IFN3 NBBUF=50);

Calcul de la taille maximale de la mémoire tampon (POOLSIZE).

Pour chaque fichier, calculer le résultat de (BUFFER SIZE * NBBUF) et cumuler lesvaleurs obtenues.

Soit un nombre de tampons égal à 280. Si les fichiers ont les tailles de CI suivantes :

Fichier CISIZEEFN1 2048EFN2 3584

EFN3 6144

alors la valeur à spécifier pour POOLSIZE devra être de :

EFN1 200* (2048 arrondi au multiple supérieur de 4 Ko) = (200*4 Ko) = 800 KoEFN2 30* (3584 arrondi au multiple supérieur de 4 Ko) = (30*4 Ko) = 120 KoEFN3 50* (6144 arrondi au multiple supérieur de 4 Ko) = (50*8 Ko) = 400 Ko

Taille maxi. mémoire tampon (POOLSIZE) = 1320 Ko

Deuxième exemple IOF

Cet exemple comporte un pool pour une application IOF accédant au moins à 5 ou6 fichiers.

EXEC_PG PG=LMNAME LIB=.LMLIBSIZE 5000 POOLSIZE=4000FILE1=IFN1 ASG1=EFN1DEF1=(IFN1 NBBUF=1000 BUFPOOL=PL01)FILE2=IFN2 ASG2=EFN2DEF2=(IFN2 NBBUF=1000 BUFPOOL=PL01)FILE3=IFN3 ASG3=EFN3DEF3=(IFN3 NBBUF=1000 BUFPOOL=PL01)FILE4=IFN4 ASG4=EFN4DEF4=(IFN4 NBBUF=1000 BUFPOOL=PL01)FILE5=IFN5 ASG5=EFN5DEF5=(IFN5 NBBUF=1000 BUFPOOL=PL01)FILE6=IFN6 ASG6=SEQFILE;


5-36 47 F2 04UF Rev04

Calcul de la taille maximale de la mémoire tampon (POOLSIZE).

Soit le pool PL01 contenant 1000 tampons. Le fichier SEQFILE, qui est un fichierséquentiel, n'est pas rattaché à ce pool.

Si les fichiers ont les tailles de CI suivantes :

Fichier CISIZEEFN1 2048EFN2 3584EFN3 6144EFN4 6144EFN5 3584

EFN6 2048

et que la taille moyenne d'un tampon est de 4 Ko, alors la valeur à spécifier pourPOOLSIZE sera de :

1000 * 4 Ko = 4 Mo

A noter que les deux exemples qui suivent sont également valables pour des applicationsIOF, à condition de remplacer les ordres JCL par leurs équivalents GCL.

Premier exemple traitement par lots

$JOB B-EXPLS USER=BULL7 HOLD HOLDOUT;STEP LMNAME .LM;SIZE 700 POOLSIZE=600;ASSIGN IFN1 EFN1;DEFINE IFN1 NBBUF=20;ASSIGN IFN2 EFN2;DEFINE IFN2 NBBUF=30;ASSIGN IFN3 EFN3;DEFINE IFN3 NBBUF=50;ENDSTEP;$ENDJOB;

Suivre la procédure indiquée dans le premier exemple IOF.

Cet exemple comporte 100 tampons. Si les fichiers ont les tailles de CI suivantes :

Fichier CISIZEEFN1 2048EFN2 3584

EFN3 6144

alors la valeur à spécifier pour POOLSIZE sera de 600 Ko, cette valeur étant obtenuecomme suit :

EFN1 20*(2048 arrondi au multiple supérieur de 4 Ko) = (20*4 Ko) = 80 KoEFN2 30*(3584 arrondi au multiple supérieur de 4 Ko) = (30*4 Ko) = 120 KoEFN3 50*(6144 arrondi au multiple supérieur de 4 Ko) = (50*8 Ko) = 400 Ko

Taille maxi. mémoire tampon (POOLSIZE) = 600 Ko


47 F2 04UF Rev04 5-37

Deuxième exemple traitement par lots

Cet exemple comporte un pool pour une application par lots accédant au moins à 5 ou6 fichiers.

$JOB B-EXPLS USER=BULL7;STEP LMNAME .LM;SIZE 500 POOLSIZE=400;ASSIGN IFN1 EFN1;DEFINE IFN1 NBBUF=100 BUFPOOL=PL01;ASSIGN IFN2 EFN2;DEFINE IFN2 NBBUF=100 BUFPOOL=PL01;ASSIGN IFN3 EFN3;DEFINE IFN3 NBBUF=100 BUFPOOL=PL01;ASSIGN IFN4 EFN4;DEFINE IFN4 NBBUF=100 BUFPOOL=PL01;ASSIGN IFN5 EFN5;DEFINE IFN5 NBBUF=100 BUFPOOL=PL01;ASSIGN IFN6 EFN6;DEFINE IFN6 NBBUF=100 BUFPOOL=PL01;ASSIGN IFN7 SEQFILE;ENDSTEP;$ENDJOB;

Soit le pool PL01 contenant 100 tampons. Le fichier SEQFILE, qui est un fichierséquentiel, n'est pas rattaché à ce pool.

La taille maximale de la mémoire tampon (POOLSIZE) s'obtient en multipliant NBBUF parle nombre de pages.

Si les fichiers ont les tailles de CI suivantes :

Fichier CISIZEEFN1 2048EFN2 3584EFN3 6144EFN4 6144EFN5 3584

EFN6 2048

et si la taille moyenne de CI est de 3584, la valeur à spécifier pour POOLSIZE sera de :

100 * (3584 arrondi au multiple supérieur de 4 Ko) = (100 * 4 Ko) = 400 Ko

A noter que la valeur de POOLSIZE (400 Ko) comprend l'espace nécessaire aux deuxtampons du fichier séquentiel.

Remarques : 1. Lorsqu'il y a plusieurs valeurs de NBBUF pour les fichiers d'unmême pool, seule la plus grande est prise en compte. Il est doncconvenu de spécifier la valeur maximale de NBBUF pour tous lesfichiers du pool.

2. Si tous les fichiers du pool ont la même taille de CI (CISIZE), lataille de tampon moyenne est égale à la valeur de CISIZE arrondieau multiple supérieur de 4 Ko.


5-38 47 F2 04UF Rev04

Jusqu'à 4000 tampons par activité peuvent être spécifiés pour les applications traitementpar lots de grande taille. A noter qu'il peut y avoir jusqu'à 32.000 tampons au niveausystème (c'est-à-dire pour l'ensemble des applications TDS et traitement par lots). Cettefonction peut être mise en oeuvre pour les applications de grande taille accédantdirectement à des fichiers UFAS. Elle doit permettre une diminution significative dunombre d'E/S.

Pour prévenir les arrêts prématurés, respecter strictement les consignes suivantes :

1. Ne pas lancer d'activité traitement par lots pendant l'exécution d'une applicationTDS, pour éviter l'arrêt prématuré de l'application TDS ou traitement par lots (coderetour SYSOV) lorsque le nombre de tampons requis est supérieur à 32.000.

2. Pour une activité traitement par lots, spécifier des valeurs suffisamment importantespour POOLSIZE et "taille-dws", afin d'éviter l'arrêt prématuré (code retourCMWSOV). Regrouper dans le même pool de tampons tous les fichiers UFAS àaccès non séquentiel.

Calcul de la valeur de POOLSIZE pour les applications traitement par lots degrande taille

Les deux facteurs importants pour le calcul de POOLSIZE sont :

• le nombre de tampons du ou des pools (jusqu'à 4000 tampons au total),

• la taille moyenne d'un tampon.

Remarque : Pour les activités de taille importante s'exécutant la nuit, à faibleniveau de multiprogrammation et disposant de beaucoup demémoire, il est préférable de prendre en compte la taille de CI(CISIZE) maximale et non moyenne.

Premier exemple (cas général)

$JOB B-EXPLS USER=BULL7;STEP LMNAME .LM;SIZE 45000 POOLSIZE=16000;ASSIGN IFN1 EFN1;DEFINE IFN1 NBBUF=4000 BUFPOOL=PL01;ASSIGN IFN2 EFN2;DEFINE IFN2 NBBUF=4000 BUFPOOL=PL01;ASSIGN IFN3 EFN3;DEFINE IFN3 NBBUF=4000 BUFPOOL=PL01;ASSIGN IFN4 EFN4;DEFINE IFN4 NBBUF=4000 BUFPOOL=PL01;ASSIGN IFN5 EFN5;DEFINE IFN5 NBBUF=4000 BUFPOOL=PL01;ASSIGN IFN6 EFN6;DEFINE IFN6 NBBUF=4000 BUFPOOL=PL01;ASSIGN IFN7 SEQFILE;ENDSTEP;$ENDJOB;

Cet exemple comporte 4000 tampons pour les six premiers fichiers (à accès direct). Cesfichiers font tous partie du pool PL01. Le 7ème fichier, séquentiel, ne fait pas partie de cepool ; il ne dispose que de deux tampons (valeur implicite).

Si tous les fichiers ont une taille de CI de 4096 octets, la taille du pool sera de :

4000 * 4 Ko) = 16000 Ko


47 F2 04UF Rev04 5-39

Deuxième exemple (avec deux pools de tampons)

La définition d'un deuxième pool de tampons peut permettre de regrouper des fichiersayant un comportement spécifique ; par exemple, des fichiers n'ayant qu'un petit nombrede CI et fréquemment utilisés peuvent résider en mémoire centrale.

JOB B-EXPLS USER=BULL7;STEP LMNAME .LM;SIZE 60000 POOLSIZE=20000;ASSIGN IFN1 EFN1;DEFINE IFN1 NBBUF=3000 BUFPOOL=PL01;ASSIGN IFN2 EFN2;DEFINE IFN2 NBBUF=3000 BUFPOOL=PL01;ASSIGN IFN3 EFN3;DEFINE IFN3 NBBUF=3000 BUFPOOL=PL01;ASSIGN IFN4 EFN4;DEFINE IFN4 NBBUF=3000 BUFPOOL=PL01;ASSIGN IFN5 EFN5;DEFINE IFN5 NBBUF=3000 BUFPOOL=PL01;ASSIGN IFN6 EFN6;DEFINE IFN6 NBBUF=1000 BUFPOOL=PL01;ASSIGN IFN7 EFN7;DEFINE IFN7 NBBUF=1000 BUFPOOL=PL02;ENDSTEP;$ENDJOB;

Cet exemple comporte 4000 tampons au total : 3000 dans le pool PL01 et 1000 dans lepool PL02.

Calcul de la valeur de POOLSIZE avec plusieurs pools

La valeur de POOLSIZE doit correspondre à la mémoire tampon totale des pools.

Soit une taille de tampon moyenne de 4 Ko pour le pool PL01, et de 8 Ko pour le poolPL02. La mémoire tampon totale (valeur de POOLSIZE) se calcule comme suit :

(3000 * 4 Ko) + (1000 * 8 Ko) = 20000 Ko (pour PL01) (pour PL02)


5-40 47 F2 04UF Rev04

5.12.5 Optimisation des paramètres de gestion des tampons

L'utilisateur peut modifier les paramètres de gestion des tampons d'une application, pouréviter un gaspillage de ressources. Plus le nombre de tampons est élevé, moins il y ad'opérations d'E/S. Pour obtenir le paramétrage optimal en matière de tampons, il estindispensable de tester différentes valeurs. Des facteurs tels que la taille maximale de lamémoire tampon (POOLSIZE) et le nombre de tampons par pool sont déterminants pourles performances d'une application (surtout s'il s'agit d'une application TDS). En fonctiondes statistiques UFAS-EXTENDED figurant dans l'historique de travail (JOR) (voir plusloin), l'utilisateur a la possibilité d'optimiser ses paramètres de gestion des tampons.

A la fin de chaque activité, les informations suivantes sont consignées dans le JOR :

• Pour chaque fichier UFAS-EXTENDED, et pour tous les fichiers d'un même pool :

- Nombre total d'accès CI, y compris CI de label, d'index et de données(GETCICOUNT).

- Nombre d'accès CI sans E/S physiques (HITCOUNT).

• Pour chaque activité :

- Nombre de suppressions de tampons (SEGDL).- Nombre de créations de tampons (SEGCR).

Les différentes opérations effectuées par UFAS-EXTENDED sur les tampons - création,suppression, réactivation - sont décrites à l'annexe E.

Pour mieux comprendre les conséquences pratiques des valeurs relatives aux tampons, ilsuffit d'étudier les statistiques figurant dans le JOR.

L'adéquation entre le nombre de tampons et la valeur de POOLSIZE permet d'optimiserl'utilisation des tampons, c'est-à-dire d'atteindre le meilleur taux d'accès sans E/Sphysiques. Ce taux s'obtient en divisant le nombre d'accès CI dans le pool par le nombretotal d'accès CI (opérations dans le pool et E/S physiques).

L'optimisation des paramètres utilisateur s'effectue comme suit :

1. Choisir la valeur de NBBUF pour chaque fichier, ou pour l'ensemble du pool detampons, de façon que le taux d'accès sans E/S physiques soit le plus élevépossible.

Taux d'accès sans E/S = HITCOUNT divisé par GETCICOUNT

2. Déterminer ensuite la valeur de POOLSIZE en fonction de celle de NBBUF. Plus lenombre de tampons est élevé, plus les temps d'accès disque diminuent, mais il fautveiller à choisir une valeur suffisante pour POOLSIZE. Normalement, USED SIZEest légèrement inférieur à POOLSIZE.


47 F2 04UF Rev04 5-41

Création/suppression de tampons dans une activité

Création

UFAS-EXTENDED crée de nouveaux tampons dans les limites fixées par la clauseRESERVE AREAS (nombre maximal de tampons) et par POOLSIZE (taille maximale dela mémoire tampon).

Lorsque l'une de ces limites est atteinte, UFAS-EXTENDED peut soit réutiliser un tamponexistant - à condition qu'il ne soit ni actif, ni utilisé pour des mises à jour différées(DEFERRED UPDATE) -, soit supprimer un ou plusieurs tampons pour libérer la placenécessaire (voir plus loin).

Le compteur SEGCR indique le nombre de tampons créés pour l'activité. Ce nombrecomprend également les 5 structures de gestion créées à l'ouverture du fichier.

Suppression

Une suppression peut avoir lieu :

• lorsqu'il n'est pas possible de réutiliser un tampon existant de la taille requise ;

• lorsque les fichiers sont fermés ;

• au niveau d'un point de reprise ;

• en fin d'activité (arrêt normal ou anormal).

Le compteur SEGDL indique le nombre de tampons supprimés, à l'exclusion desstructures de gestion de fichier.

Après avoir déterminé la valeur de POOLSIZE et le nombre maximal de tampons,s'assurer que le nombre de tampons créés (compteur SEGCR) est proche du nombredéfini dans la clause RESERVE AREAS. Le résultat de :

SEGCR divisé par le nombre de tampons

doit tendre vers 1 pour une activité traitement par lots, et être le plus petit possible dans lecas d'une application TDS.

Pour optimiser ce rapport, limiter au maximum le nombre de tailles de CI (CISIZE)différentes. En revanche, dans le cas d'une application TDS, il est préférable d'avoir 3 ou4 tailles de CI différentes pour les fichiers UFAS-EXTENDED.


5-42 47 F2 04UF Rev04

5.12.6 Statistiques UFAS-EXTENDED figurant dans le JOR

Ce chapitre décrit les différentes statistiques rencontrées dans le JOR. Il est important deles consulter pour vérifier l'efficacité du pool.

>>> IFN=<nom-de-fichier-interne> REWRITECNT=a DELETECNT=b WRITECNT=c READCNT=d

>>> EFN=<nom-de-fichier-externe> GETCICOUNT=e HITCOUNT=f IOCOUNT=g

==> POOL=<nom-pool> NBFILES=h NBBUF=i GETCICOUNT=j HITCOUNT=k

>>> XUFAS STEP STATISTICS STEP=<nom-activité> POOLSIZE=l USED SIZE=m NBPOOLS=n AVAIL CI=p FREE CI=q TOTAL CI=r SEGCR=s SEGDL=t

READIOCT=u WRITEIOCT=v

Les statistiques sur les fichiers sont fournies à la fois pour les noms internes (IFN) et pourles noms externes (EFN).

A chaque nom de fichier interne (IFN) correspondent les quatre compteurs suivants :

• réécrits.

• supprimés.

• écrits.

• lus.

REWRITECNT Nombre d'articles logiques réécrits.

DELETECNT Nombre d'articles logiques supprimés.

WRITECNT Nombre d'articles logiques écrits.

READCNT Nombre d'articles logiques lus.

REMARQUE IMPORTANTE

En COBOL 85, si l'article réécrit n'a pas la même longueur que l'articleexistant, l'opération de réécriture est considérée comme unesuppression suivie d'une insertion. Dans ce cas, les articles sontcomptabilisés au niveau de DELETECNT et WRITECNT, et non auniveau de REWRITECNT.

Les statistiques "nom-de-fichier-interne" ne sont pas visualisées pour les aires IDS II, carIDS utilise des verbes spécifiques (par exemple : SEARCH, STORE, etc.).


47 F2 04UF Rev04 5-43

A chaque nom de fichier externe (EFN) correspondent les trois compteurs suivants :

GETCICOUNT Nombre total d'accès CI (sur disque et dans le pool detampons).

HITCOUNT Nombre d'accès CI dans le pool (sans E/S physiques).

IOCOUNT Nombre d'opérations d'E/S physiques (chaque opération portesur un CI.)

Statistiques relatives au pool de tampons :

POOL Nom du pool (généralement, nom de l'application, lorsqu'il s'agitd'une application TDS).

NBFILES Nombre maximal de fichiers pouvant être ouvertssimultanément pour le pool considéré.

NBBUF Nombre maximal de tampons déclarés pour le pool considéré.NBBUF n'a pas de sens pour le pseudo-pool, qui contient desfichiers non contrôlés par TDS.

GETCICOUNT Nombre total d'accès CI (CI de données, d'index et de label).

HITCOUNT Nombre d'accès CI sans E/S physiques.

Autres compteurs au niveau activité :

POOLSIZE Taille maximale de la mémoire réservée aux tampons pourl'activité, en octets.

USED SIZE Quantité de mémoire tampon (POOLSIZE) effectivementutilisée, en octets. USED SIZE est forcément inférieur àPOOLSIZE.

NBPOOLS Nombre maximal de pools ouverts simultanément.

AVAIL CI Nombre de rubriques disponibles au niveau système aprèsexécution de l'activité.

FREE CI Nombre de rubriques inactives (c'est-à-dire rubriquesdisponibles + rubriques réservées) en fin d'exécution del'activité.

TOTAL CI Nombre maximal de rubriques actives au niveau système pourtous les travaux en cours d'exécution.

SEGCR Nombre de créations de tampons (et structures de gestion defichier).

SEGDL Nombre de suppressions de tampons.

READIOCT Nombre d'opérations physiques d'entrée (voir remarque ciaprès).

WRITEIOCT Nombre d'opérations physiques de sortie (voir remarque ciaprès).


5-44 47 F2 04UF Rev04

Remarque : La somme des valeurs READIOCT et WRITEIOCT estgénéralement égale au cumul des valeurs IOCOUNT (au niveaufichier). Mais en cas de relance après un arrêt prématuré de TDS, ilest possible que ces deux sommes diffèrent.

Exemple de statistiques au niveau fichier

>>> IFN=FILUP

REWRITECNT=0 DELETECNT=1 WRITECNT=92 READCNT=608

>>> EFN=TDS1.FILUP

GETCICOUNT=1242 HITCOUNT=1068 IOCOUNT=270

Statistiques sur le fichier TDS1.FILUP (nom de fichier interne = FILUP) :

• aucune mise à jour d'article,• suppression d'un article,• écriture de 92 nouveaux articles,• lecture de 608 articles.

Ces opérations ont impliqué 1242 accès CI, dont 1068 sans E/S physiques, les CI requisétant déjà en mémoire ; au total, 270 E/S physiques ont été nécessaires pour ce fichier.

A noter que :

GETCICOUNT = HITCOUNT + nombre de lectures physiques

IOCOUNT = nombre de lectures physiques + nombre d'écritures physiques

Exemple de statistiques au niveau pool

==> POOL=TDS1

NBFILES=34 NBBUF=500 GETCICOUNT=10225 HITCOUNT=7951

==> POOL=DEFT

NBFILES=1 NBBUF=MEANINGLESS GETCICOUNT=11 HITCOUNT=8


47 F2 04UF Rev04 5-45

Dans cet exemple,

• ouverture simultanée de 34 fichiers contrôlés par TDS pour l'application TDS1 ;

• nombre de tampons partagé par ces fichiers : 500 (clause RESERVE AREAS) ;

• nombre total d'accès CI (CI de données, d'index et de label) pour tous les fichierscontrôlés par TDS : 10.225 ;

• parmi ces 10.225 accès CI, 7951 ont été effectués sans E/S physiques, en réactivant7951 tampons.

Pour un fichier non contrôlé par TDS (le minimum), il y a eu 11 accès CI, dont 8 au seindu pool, d'où un moins grand nombre d'E/S physiques.

Exemple de statistiques au niveau activité

>>>XUFAS STEP STATISTICS STEP=TDS1 POOLSIZE = 3072000 USED SIZE = 2339288 NBPOOLS = 2 AVAIL CI = 110 FREE CI = 1215 TOTAL CI = 1005 SEGCR = 572 SEGDL = 567

READIOCT = 2243 WRITEIOCT = 1438

Dans cet exemple, pour l'application transactionnelle TDS1, la valeur de POOLSIZE estde 3.072.000 octets, en accord avec la valeur de POOLSIZE dans l'ordre JCL $SIZE(3000 Ko).

L'espace mémoire effectivement utilisé par les tampons est de 2.339.288 octets (poolDEFT compris).

Cet exemple comporte deux pools. A noter qu'en général, TDS crée un pool portant lenom de l'application TDS pour les fichiers contrôlés par TDS, et le pool implicite DEFTpour les fichiers non contrôlés par TDS. Le pool DEFT est toujours créé pour uneapplication TDS.

Chaque travail dispose de 110 rubriques de table interne après activation. Le nombre derubriques disponibles - non réservées à un travail particulier - est de 1215. Le nombretotal de rubriques créées est de 1005. Cette information est utile pour la mise au point.

Statistiques sur l'activité TDS1 :

• création de 572 tampons (structures de gestion comprises) et suppression de567 tampons,

• 2243 opérations physiques de lecture et 1438 opérations physiques d'écriture pourl'ensemble des fichiers UFAS-EXTENDED.


5-46 47 F2 04UF Rev04

5.13 JOURNALISATION

Les paragraphes suivants décrivent brièvement les principales techniques dejournalisation mises en oeuvre pour les fichiers UFAS-EXTENDED. L'optionJOURNAL=BOTH permet de demander les deux journaux Avant et Après pour s'assurerune protection maximale, ce qui implique des opérations d'entrée/sortie supplémentaires.

Pour les fichiers catalogués, le type de journalisation voulu peut être enregistré dans larubrique catalogue.

Pour plus de précisions sur la journalisation, se reporter au manuel traitant de lareconstitution des fichiers (19UF).

5.13.1 Journal Avant (BEFORE)

Le journal Avant permet d'enregistrer une copie de chaque article avant sa modificationpar le programme de traitement.

Cette fonction système peut être demandée au moyen du catalogue, ou du paramètreJOURNAL du groupe DEFn (ou de l'ordre JCL DEFINE).

Exemple :

EXEC_PG MONPROGRAMME FILE1 = INOU ASG1 = JC.FDB DEF1 = (JOURNAL = BEFORE);

En cas d'arrêt prématuré du programme, les images Avant enregistrées sont utilisablespour effectuer une restauration non actualisée (rollback) du contenu du fichier.

M ém o ire to ta le (e n M o)

P o urce n tag e d e lam ém o ire to ta le

T a ille de la m ém o ireta m po n p ou r tou te s

les a pp lica tio n s TD S(e n M o )

16

32

64

2 0 %

3 0 %

5 0 %

3 ,2

9 ,6

32

Figure 5-15. Possibilités d'utilisation du journal Avant

Le mode d'ouverture APPEND en GPL est l'équivalent du mode EXTEND en COBOL.

L'astérisque (*) indique que le fichier peut être journalisé uniquement en accès direct.Dans la colonne EXTEND/APPEND, il ne peut s'agir que de fichiers GPL.


47 F2 04UF Rev04 5-47

Le tiret (-) indique que le mode d'ouverture I-O n'est pas utilisable.

Lorsque la fonction journal Avant n'est pas spécifiée, la reconstitution des fichierss'effectue par le biais de points de reprise.

5.13.2 Journal Après (AFTER)

Le journal Après permet d'enregistrer une copie de chaque article après sa mise à jour.En cas d'incident au niveau du logiciel ou d'un volume, les images Après enregistréessont utilisables pour effectuer une restauration actualisée (rollforward) du contenu dufichier.

Cette fonction système peut être demandée au moyen du catalogue (ce qui estpréférable), ou du paramètre JOURNAL du groupe DEFn (ou de l'ordre JCL DEFINE).

Exemple :

EXEC_PG MONPROGRAMME FILE1 = INOU ASG1 = JC.FDB DEF1 = (JOURNAL = AFTER);

O rganisationdu fich ier

M ode d 'ouverture du fich ier

O U TPUTEXTEND

(APPEN D) I-O

Séquentiel le bande

Séquentiel le disque

Séquentiel le indexée

R elative

-

O ui

O ui

O ui

Non

Non

O ui*

Non

N on

N on

O ui*

O u i

Figure 5-16. Possibilités d'utilisation du journal Après

L'astérisque (*) indique que l'ouverture d'un fichier séquentiel indexé en mode EXTENDn'est possible qu'en COBOL 85.

Le tiret (-) indique que le mode d'ouverture I-O n'est pas utilisable.

Le mode GPL APPEND est l'équivalent du mode EXTEND en COBOL.

Dans une application TDS, il peut être préférable d'utiliser non pas le journal Avant, maisle journal Après et l'option mise à jour différée (Deferred Update) ; cette deuxièmesolution permet de réduire les E/S et par conséquent d'améliorer les temps de réponse.Mais toute réorganisation (incrémentale) de CI d'un fichier en mise à jour différéeprovoque l'envoi du code retour WDNAV.


5-48 47 F2 04UF Rev04

5.14 INTEGRITE DES FICHIERS

En cas d'arrêt prématuré du traitement, de blocage du système ou d'erreurs E/Spersistantes, UFAS-EXTENDED tente de maintenir l'intégrité des fichiers en évitant de leslaisser dans un état instable. Si c'est impossible, l'utilisateur en est averti par un coderetour.

Un fichier est en état instable lorsqu'il n'a pas été fermé correctement, et que, parconséquent, le label début ou fin n'a pu être convenablement écrit. Un index est en étatinstable soit lorsque des articles n'ont pas de rubrique d'index correspondante, soitlorsque des rubriques d'index ne renvoient à aucun article.

5.14.1 Phase de création

1. Lorsque l'utilisateur ouvre un fichier en mode OUTPUT :

Il crée de nouveaux articles ; s'il reste d'anciens articles dans le fichier, ils sontsupprimés. Le nouveau fichier ne contient que les articles écrits entre son ouvertureet sa fermeture.

La reconstitution du fichier s'effectue nécessairement par le biais de points de reprise. Iln'est pas possible d'utiliser la journalisation Avant ou Après au moment de la création dufichier.

2. Lorsque l'utilisateur ouvre un fichier en mode EXTEND (équivalent GPL =APPEND) :

Les nouveaux articles sont écrits à la suite du dernier article contenu dans le fichier.

Lors de la relance consécutive à un blocage du système, l'utilisateur peut avoir àrépondre à la question REPEAT FROM CHECKPOINT nn ? pour un fichier :

• s'il répond oui (YES), le fichier est restauré dans l'état où il se trouvait lors du dernierpoint de reprise, et l'activité s'exécute jusqu'au bout,

• s'il répond non (NO), le fichier reste en état instable,

Lors du dernier point de reprise en cas d'arrêt prématuré de l'activité, l'utilisateur peutavoir à répondre à la question REPEAT FROM CHECKPOINT nn ? pour un fichier :

• s'il répond oui (YES), le fichier est restauré dans l'état où il se trouvait lors du dernierpoint de reprise, et l'activité s'exécute jusqu'au bout,

• s'il répond non (NO), le fichier est refermé et reste dans l'état où il se trouvait aumoment de l'arrêt prématuré de l'activité.


47 F2 04UF Rev04 5-49

5.14.1.1 Fichiers sans clés secondaires

En cas d'arrêt prématuré du programme utilisateur ou si l'opérateur émet une commandeCANCEL_JOB, le fichier est fermé dans l'état où il se trouvait au moment de l'arrêt.

En cas de blocage du système, le fichier n'est pas refermé et reste en état instable. Toutetentative de réouverture dans un mode autre que OUTPUT provoque l'envoi du codeDATANAV.

5.14.1.2 Fichiers avec clés secondaires

La procédure recommandée pour créer des clés secondaires est décrite au chapitre 4(paragraphe 4.8.1).

Pour ce type de fichiers, il y a d'abord création de l'index primaire, puis création des indexsecondaires. Lorsque le programme utilisateur contient la clause COBOL APPLY NO-SORTED-INDEX-ON, les index secondaires ne sont pas générés automatiquement à lacréation du fichier. Dans ce cas, ils doivent être créés après, au moyen de la commandeSORT_INDEX (équivalent JCL = SORTIDX). En GPL, il n'y a jamais d'index secondairespour un fichier ouvert en mode OUTPUT.

En cas d'arrêt prématuré ou de blocage du système au cours de la création des indexsecondaires, ceux-ci sont laissés en état instable. Toute tentative d'ouverture du fichierdans un mode autre que INPUT ou OUTPUT, ou pendant l'exécution de SORT_INDEX,provoque l'envoi du code SCIDXNAV. En cas d'ouverture en mode INPUT, toute tentatived'accès au fichier par les clés secondaires provoquera également l'envoi du codeSCIDXNAV.

5.14.2 Phase de traitement

5.14.2.1 Fichiers ouverts en entrée (INPUT)

Fichiers protégés parjournalisation

Pour lire un fichier instable ouvert en mode INPUT, il fautavoir recours aux utilitaires de reconstitution de fichiers.

Fichiers non protégés parjournalisation

Un fichier (stable ou instable) ouvert en mode INPUT nepeut être lu qu'en accès séquentiel. Ce mode d'ouverturepermet la restauration d'un fichier instable.

D'une manière générale, toute tentative de lecture en accès direct par l'intermédiaire d'unindex instable est refusée avec envoi de l'un des codes retour suivants :

• FLNAV (fichier non disponible) s'il s'agit de l'index primaire,

• SCIDXNAV (index secondaire non disponible) s'il s'agit d'un index secondaire.


5-50 47 F2 04UF Rev04

5.14.2.2 Fichiers ouverts en entrée-sortie (I-O)

En COBOL 85, ce mode d'ouverture et le mode EXTEND (équivalent GPL = APPEND)permettent l'utilisation du journal Avant et du journal Après avec les fichiers séquentielsindexés (voir figure 5.16).

L'image Avant de chaque article est enregistrée dans le journal avant sa modification.

5.14.2.3 Fichiers sans clés secondaires

En cas d'arrêt prématuré pendant une réorganisation incrémentale de CI, l'arrêt effectifn'intervient qu'une fois cette opération terminée. Le fichier est ensuite refermé et laissé enétat stable.

En cas de blocage du système, le fichier n'est pas refermé et reste en état instable. Troiscas sont alors possibles :

1. Le fichier n'est pas protégé par la journalisation :

Toute tentative de réouverture du fichier est acceptée.

Lorsque le fichier est réouvert en mode INPUT, ses index sont considérés commeendommagés ; tout accès par clé sera donc refusé, et provoquera l'envoi du codeFLNAV.

Lorsque le fichier est réouvert en mode I-O, il est automatiquement pris en chargepar le programme de sauvetage (File Salvager) d'UFAS-EXTENDED. Si uneréorganisation incrémentale était en cours au moment du blocage, il rétablit lacohérence du fichier à ce point.

Remarque : En traitement par lots, lorsque le journal Avant n'est pas utilisé etque des articles sont insérés entre un point de reprise et unblocage du système, le code retour DUPKEY (valeurs de clés déjàexistantes) est émis si, après relance à chaud (warm restart), leprogramme fait une nouvelle tentative d'insertion de ces articles ;les articles ne sont pas insérés, le traitement se poursuitnormalement, et le code DUPKEY n'est pas pris en compte.

2. Le fichier est protégé par le journal Avant :

L'utilisation du journal Avant évite que le fichier ne soit laissé en état instable : lesimages avant modification sont réécrites automatiquement au moment de la relanceà chaud ; le sauvetage du fichier n'est donc pas nécessaire.

3. Le fichier est protégé par le journal Après et l'option mise à jour différée :

L'utilisation du journal Après et de l'option mise à jour différée (applications TDSuniquement) évite que le fichier ne soit laissé en état instable :

- Le journal Après permet de garder une image de chaque article après samodification et de garantir ainsi l'intégrité du fichier contre toutes sortesd'incidents.

- L'option mise à jour différée constitue une alternative au journal Avant. Lesmises à jour ne sont pas écrites immédiatement dans le fichier ; en casd'incident, ces mises à jour ne sont pas enregistrées.


47 F2 04UF Rev04 5-51

5.14.2.4 Fichiers avec clés secondaires

En cas d'arrêt prématuré pendant une réorganisation incrémentale de CI, l'arrêt effectifn'intervient qu'une fois cette opération terminée. Le fichier est ensuite refermé et laissé enétat stable. Les accès nécessaires pour la reprise de la mise à jour sont protégés de lamême manière. La cohérence des index secondaires avec l'index primaire et les donnéesn'est donc pas affectée.

En cas de blocage du système, le fichier n'est pas refermé et reste en état instable. Sesindex (primaire et secondaires) sont endommagés. Trois cas sont alors possibles :

1. Le fichier n'est pas protégé par la journalisation :

Le mécanisme de sauvetage est différent selon le type d'index :

- le sauvetage de l'index primaire s'effectue automatiquement (voirparagraphe 5.14.2.3) ;

- les index secondaires doivent être reconstitués au moyen de la commandeSORT_INDEX (équivalent JCL = SORTIDX). Le programme de sauvetageémet pour le JOR un message demandant le lancement de SORT_INDEX.Toute tentative d'accès au fichier par l'intermédiaire d'une clé secondaire avantexécution de SORT_INDEX (ou SORTIDX) est refusée et provoque l'émissiondu code SCIDXNAV.

2. Le fichier est protégé par le journal Avant

Voir "fichiers sans clés secondaires" (paragraphe 5.14.2.3).

3. Le fichier est protégé par le journal Après et l'option mise à jour différée(applications TDS uniquement) :

Voir "fichiers sans clés secondaires" (paragraphe 5.14.2.3).

Remarque : La reconstitution des index secondaires est plus longue que lesauvetage des index primaires.


5-52 47 F2 04UF Rev04

5.14.3 Phase d'extension

UFAS-EXTENDED permet l'extension statique ou dynamique des fichiers séquentiels etséquentiels indexés.

Les fichiers relatifs ne peuvent faire l'objet d'une extension statique. Ils ne sontextensibles que dynamiquement en accès séquentiel sous les modes d'ouvertureOUTPUT ou EXTEND (COBOL 85 uniquement). L'équivalent GPL d'EXTEND estAPPEND. Lorsqu'un fichier relatif est ouvert en mode APPEND, l'extension s'effectuegénéralement à partir de la fin du fichier, mais le GPL permet à l'utilisateur de spécifierl'adresse d'un article à partir duquel effectuer l'extension.

Extension dynamique :

Le paramètre INCRSIZE de la commande BUILD_FILE (équivalent JCL = PREALLOC),de la commande CREATE_FILE (équivalent JCL = FILALLOC) ou du groupe ALCn(équivalent JCL = ALLOCATE) permet de spécifier l'incrément à utiliser pour l'extensionautomatique du fichier, chaque fois qu'il sera plein (voir chapitre 6).

La commande MODIFY_FILE (équivalent JCL = FILMODIF) permet de modifier la valeurdu paramètre INCRSIZE (voir chapitre 6) pour un fichier catalogué.

Extension statique :

La demande d'espace s'effectue au moyen du paramètre SIZE de la commandeMODIFY_FILE_SPACE (voir chapitre 6). L'équivalent JCL est le paramètre EXTEND del'ordre PREALLOC.

Dans les deux cas, l'extension n'a lieu que si le volume contient encore assez d'espacelibre.

En cas de blocage du système pendant cette opération, UFAS-EXTENDED assureautomatiquement l'affectation de place supplémentaire à la réouverture du fichier.

5.14.4 Erreurs d'E/S persistantes

Deux cas sont à envisager :

• Si le fichier est protégé par le journal Après, l'utilisateur peut, au moyen de lacommande RESTORE_FILE (équivalent JCL = FILREST), le restaurer à partir d'unesauvegarde antérieure, puis exécuter l'utilitaire ROLLFWD pour actualiser cetterestauration à l'aide du journal. L'utilitaire ROLLFWD est décrit dans le manuel traitantde la reconstitution des fichiers (18UF).

• Si le fichier n'est pas protégé par le journal Après, l'utilisateur ne peut que le restaurer àpartir d'une sauvegarde antérieure, au moyen de la commande RESTORE_FILE(équivalent JCL = FILREST).

47 F2 04UF Rev04 6-1

6. Fichiers disque - Création et modification


Généralités.

• Réservation d'espace.

• Taille de CI (paramètre CISIZE).

- Taille de CI recommandée par types de disques.- Capacités de stockage par types de disques.

• Taille initiale du fichier (paramètre SIZE).

• Taille d'incrément (paramètre INCRSIZE).

• Simulation de réservation d'espace (CREATE_FILE).

• Calculs d'espace pour :

- un fichier séquentiel.- un fichier relatif.

• Paramétrage des fichiers séquentiels indexés.

- Taille de CI (paramètre CISIZE).- Pourcentage d'espace libre par CI (paramètre CIFSP).- Insertion de masse.

• Calculs d'espace :

- sans index secondaires,- avec index secondaires.

• GCL de création, de listage et de modification.


6-2 47 F2 04UF Rev04

6.2 GENERALITES

Avant de pouvoir accueillir des fichiers, les volumes disque doivent faire l'objet d'unepréparation. Cette opération comprend l'écriture des labels, et le formatage et le contrôledes pistes. Elle s'effectue au moyen d'une des commandes GCL suivantes :

PREPARE_DISK (PRPD)

PREPARE_VOLUME (PRPV)

Ces deux commandes sont décrites dans le volume 2 du manuel de référence del'utilisateur IOF.

L'équivalent JCL de ces commandes est l'ordre VOLPREP, décrit dans le manuel traitantdes utilitaires de gestion de données.

La création d'un fichier, qui comprend la réservation d'espace et la définition des attributs(s'ils ne sont pas implicites, ou fournis par un modèle existant, ou encore spécifiés dans leprogramme utilisateur) peut s'effectuer de plusieurs manières :

• Commande GCL BUILD_FILE (BF), traitée plus loin dans ce chapitre ; son équivalentJCL est l'ordre PREALLOC.

• Commande GCL CREATE_FILE (CRF), traitée plus loin dans ce chapitre, qui permetde simuler une réservation d'espace pour un fichier ; son équivalent JCL est l'ordreFILALLOC.

• Groupe de paramètres GCL ALCn, traité plus loin dans ce chapitre ; son équivalentJCL est l'ordre ALLOCATE.

• Paramètre GCL DYNALC des utilitaires de gestion de fichier ; son équivalent JCL estl'ordre OUTALC.

Fichiers disque - Création et modification

47 F2 04UF Rev04 6-3

6.3 RESERVATION D'ESPACE

Pour le système, l'unité d'affectation de place est la piste ou le cylindre pour les fichiersVBO, et le bloc pour les fichiers FBO (voir chapitre 1). A l'exécution, UFAS-EXTENDEDaffecte les pistes ou les cylindres (VBO) ou les blocs (FBO) sous la forme d'un ouplusieurs fragments de volume.

Un fragment (extent) est un ensemble de pistes, de cylindres ou de blocs contigus dansun volume. Le nombre maximum de fragments affectables à un fichier par volume est de16 (valeur implicite : 5 fragments). Dans cette limite, l'utilisateur peut spécifier son propremaximum (un seul fragment, par exemple) au moyen du paramètre MAXEXT.

Le paramètre UNIT permet d'indiquer l'unité d'affectation correspondant à la tailledemandée. Suivant la commande, les valeurs possibles sont RECORD (article), CI(intervalle de contrôle), CYL (cylindre), TRACK (piste), BLOCK (bloc) et 100KB (quantumde 100 Ko). A noter que ces deux dernières unités sont propres aux fichiers FBO.

Pour les disques FSA (qui n'acceptent que l'organisation FBO), il est recommandéd'utiliser UNIT = BLOCK ou UNIT = 100KB (voir 6.8.1 pour une description du paramètreUNIT). Pour des raisons de compatibilité avec le GCL/JCL existant, il est toujourspossible de spécifier UNIT = CI, CYL, TRACK ou RECORD. Mais UFAS-EXTENDEDeffectue toujours la réservation d'espace en blocs sur les disques, avec les équivalencessuivantes :

• 1 cylindre = 1 000 Ko

• 1 piste = 50 Ko

Si UNIT = CI (commande BUILD_FILE avec SIZE) VBO. Le système doit convertir les CIen pistes, car le CI n'est pas une unité d'affectation réelle. Avec UNIT = CI, le calculs'effectue en fonction de la taille de CI (CISIZE). A noter que le nombre maximum de CIpar fichier est de :

16 777 215 (2 puissance 24 moins 1).

FBO. Le système doit convertir les CI en blocs. Si UNIT = BLOCK (FBO)

Le système affecte directement le nombre de blocs demandés.

Si UNIT = RECORD (commande BUILD_FILE avec SIZE)

Le système doit effectuer une conversion en nombre de pistes (ou de blocs), car l'articlen'est pas une unité d'affectation réelle. Le calcul s'effectue en fonction des tailles d'articleet de CI (RECSIZE et CISIZE).

Après affectation d'un fichier UFAS-EXTENDED séquentiel indexé avec UNIT =RECORD, il subsiste parfois une certaine quantité d'espace libre. Voir plus loin dans cechapitre.

Si UNIT = CYL ou TRACK

VBO le système affecte directement le nombre de cylindres ou de pistes demandé.FBO le système convertit les pistes ou cylindres en blocs.

A noter qu'il est préférable de réserver l'utilisation de ces deux unités aux disques non-FSA.


6-4 47 F2 04UF Rev04

La taille initiale du fichier peut être spécifiée au moyen du paramètre SIZE (affectationglobale) ou au moyen du paramètre SPLIT associé au paramètre SPLITDVC (affectationfractionnée dite "volume par volume").

La commande BUILD_FILE permet le choix entre SIZE et SPLIT. La commandeCREATE_FILE et le groupe ALCn n'autorisent que SIZE. Ces deux modes d'affectationsont décrits plus loin dans ce chapitre.

L'adresse à partir de laquelle effectuer la réservation s'exprime :

• en cylindres/pistes pour les fichiers VBO,

• en blocs pour les fichiers FBO.

A l'affectation, UFAS-EXTENDED balaye la liste des fragments libres et alloue le pluspetit de ceux qui peuvent fournir la totalité de l'espace requis, s'il en existe.

40 2 3 2 5 60

L is te de s fra g m e n ts lib re s

Dans cet exemple les fragments libres sont respectivement de 40, 23, 25 et 60 cylindres.Si la demande est de 24 cylindres, UFAS-EXTENDED les prend dans le fragment de 25cylindres. Après l'opération, les fragments restant libres sont de 40, 23, 1 et 60 cylindres,comme indiqué dans la figure ci-après :

40 2 3 1 60

L is te d e s fra gm e n ts re s tan t lib re s

Si l'espace requis excède la taille du plus grand fragment libre, UFAS-EXTENDED affectece dernier et complète comme suit :

• Il prend les cylindres manquants dans le plus petit fragment libre pouvant les fournir, oubien

• S'il n'y a plus de fragment libre égal ou supérieur au nombre de cylindres manquants, ilchoisit le plus grand qui reste et continue sa recherche.


47 F2 04UF Rev04 6-5

Donc, si l'espace requis est de 86 cylindres, et que les fragments libres font (60 + 40),UFAS-EXTENDED affecte d'abord celui de 60 cylindres, puis prend les 26 cylindres dansle fragment de 40 cylindres. Après l'opération, les fragments restant libres sont de 14, 23et 1 cylindres, comme indiqué dans la figure ci-après :

14 23 1

L is te d e s fra gm e n ts re s tan t lib re s

6.3.1 Taille de CI (paramètre CISIZE)

Le paramètre CISIZE spécifie la taille de CI en octets ; sa valeur doit être déterminéeavec le plus grand soin. La taille de CI spécifiée ne peut être qu'un multiple de 512 ;UFAS-EXTENDED arrondit, si nécessaire, la valeur fournie par l'utilisateur au multipleimmédiatement supérieur. Le tableau 6-1 indique les tailles de CI recommandées pourune utilisation optimale de l'espace disponible sur les disques non-FSA, suivant leurclasse d'appareils. A noter cependant que, dans les applications TDS, le temps deréponse - en relation avec le nombre de niveaux d'index - peut être un facteur plusimportant.

La taille des tampons et le temps de réorganisation incrémentale sont directementproportionnels à la taille de CI. En principe, plus la taille de CI (CISIZE) est importante,moins le nombre de réorganisations incrémentales de CI est élevé, et moins il y ad'opérations d'E/S. A noter que la taille d'un tampon est égale à CISIZE arrondi aumultiple supérieur de 4 Ko lorsque VERSION = CURRENT, (CISIZE+32) arrondi aumultiple supérieur de 4 Ko lorsque VERSION = PREVIOUS.

Le nombre d'articles de format variable logeables dans un CI dépend du total de leurslongueurs, sachant qu'un article ne peut être réparti sur deux CI.


6-6 47 F2 04UF Rev04

6.3.2 Tailles de CI recommandées pour les fichiers sur disques non-FSA

Les tailles de CI indiquées au tableau 6-1 assurent une utilisation optimale de l'espace surles disques non-FSA.

Tableau 6-1. Valeurs recommandées pour CISIZE

Tableau 6-1. Valeurs recommandées pour CISIZE

32 2 5 619 4 5 612 8 0 0 9 2 1 6 7 1 6 8 6 1 4 4 5 1 2 0 4 0 9 6 3 5 8 4 3 0 7 2 2 5 6 0 2 0 4 8 1 5 3 6 1 0 2 4 51 2

2 86 7 21 43 3 6 9 21 6 6 65 6 5 12 0 4 09 6 3 58 4 3 07 2 2 56 0 2 04 8 1 53 6 1 02 4 51 2

1 (9 8% ) 2 (9 8% ) 3 (9 5% ) 4 (9 1% ) 5 (8 8% ) 6 (8 4% ) 7 (8 6% ) 8 (8 4% )1 0 (8 8% )1 2 (8 4% )1 5 (7 9% )2 1 (7 4% )3 4 (6 0% )

2 4 4 8 7 2 9 612 014 416 819 224 028 836 050 481 6

15 30 45 60 75 90105120135165195225285390600

1 (8 1 % ) 2 (9 8 % ) 3 (9 6 % ) 4 (9 3 % ) 5 (9 0 % ) 6 (9 3 % ) 7 (9 0 % ) 8 (8 3 % ) 9 (7 9 % )1 1 (8 5 % )1 3 (8 1 % )1 5 (7 8 % )1 9 (6 9 % )2 6 (5 4 % )4 0 (4 2 % )

M S /B 1 0 M S /D 5 0 0

C IS IZEN b re d e C Ide do n né e spa r p is te

N b re d e C Ide do n né e spa r p is te

N b re d e C Ide do n né e sp a r cy lin d re

C IS IZEN b re d e C Ide do n né e sp a r cy lin d re

Les différents types de disques non-FSA sont les suivants :

Classe d'appareils Unité de disques

MS/B10 unité de disques de 1 gigaoctet

MS/D500 MSU1007

A la création du fichier, l'utilisateur doit également prendre en compte d'autres élémentstels que le coût mémoire des tampons en fonction de la taille de CI. La gestion destampons est traitée au chapitre 5. Pour les applications TDS, le facteur le plus importantest le nombre de niveaux d'index des fichiers.

Dans le tableau 6-1, les pourcentages figurant entre parenthèses indiquent le tauxd'occupation des pistes.

Depuis la version V5 de GCOS 7, la mémoire est découpée en pages de longueur fixe (4Ko). Un CI peut être réparti sur plusieurs pages, mais une page ne peut pas contenir deuxCI. Il est important de choisir la valeur de CISIZE de manière à optimiser le remplissagedes pages.

nombre de pages = (CISIZE divisé par 4096) arrondi au multiple supérieur de 4 Ko

Si par exemple CISIZE = 4 096, il faudra 1 page mémoire par CI.


47 F2 04UF Rev04 6-7

6.3.3 Capacités de stockage par type de disques

Tableau 6-2. Capacité des volumes sur disques FSA (en nombre de CI)

Tableau 6-2. Capacité des volumes sur disques FSA

512102415362048256030723584409646085120563261446656716876808192870492169728

102401228814336163841843220480225282457626624286723072032256

628400314200209466157100125680104733

897717855069822628405712752366483384488541893

39 27536 96434 91133 073 31 42026183224421963717455157101428113091120841122110473

9974

1302800651400434266325700260560217133186114162850144755130280118436108566100215

930578685381425766357237768568651405428346528407123618832570296092714125053232642171320679

C IS IZ EFS A

320 M oF S A

660 M oLS S V1

1600 M oLS S V 2

2500 M o

26696001334800

889866667400533920444933381371333700296622266960242690222466205353190685177973166850157035148311140505133480111233

95342834257415566740606725561651338476714449342374

4154100207705013847001038525

830820692350593442519262461566415410377645346175319546296721276940259631244358230783218636207705173087148360129815115391103852

944118654379886741806923565938

(en oc te ts )

C apac ité du volum e

En divisant la capacité d'un volume par la taille de CI, on obtient le nombre maximum deCI que peut contenir ce volume. Par exemple, si CISIZE = 4 096 (octets) et si le volume aune capacité de 320 mégaoctets, il peut contenir jusqu'à 78 550 CI.


6-8 47 F2 04UF Rev04

Tableau 6-3. Capacité des volumes sur disques non-FSA

Tableau 6-3. Capacité des volumes sur disques non-FSA

M S /D 500 M S /B 1 0

C la sses d 'ap pa re ils

N o m b re d e c y lin d res p a r vo lum e

C y lin d re s sup p lé m e n ta ire s p ou rp is te s d e re m p la cem en t

P is te s pa r cy lin d re

N o m b re to ta l de p is te s (san sles p is tes d e rem p la ce m e n t)

N o m b re d 'o c te ts pa r p is ted is po n ib le s p ou r l'u tilisa teu r

N o m b re d 'o c te ts pa r cy lin d re

C a pa cité to ta le (a pp ro x ., enm ég a -o cte ts )

707

2

24

16 9 68

29 0 13

696 312

500

1730

5

15

25950

39381

590715

1000

Les tableaux 6-4 et 6-5 présentent la capacité respective de volumes de même classed'appareils, mais formatés différemment (FBO avec blocs de données de 4 Ko dans lepremier cas, VBO dans le deuxième cas), et ce pour différentes tailles de CI.

On suppose que la totalité du volume est disponible (pas de zone DSMGT) et que lefichier considéré est monofragment. A noter qu'un CI peut être réparti sur deux pistesconsécutives dans un volume FBO.


47 F2 04UF Rev04 6-9

Tableau 6-4. Capacité respective des volumes VBO et FBO sur disques MS/D500

Tableau 6-4. Capacité respective des volumes VBO et FBO sur disques MS/D500

V BO FB OC ISIZED iffé rence (enpourcen tage)

57 6 9 1235 6 3 2825 4 2 2020 3 6 1616 9 6 8013 5 7 4411 8 7 7610 1 8 08 8 4 84 0 8 4 84 0 6 7 87 2 6 7 87 2 6 7 87 2 6 7 87 2 5 0 90 4 5 0 90 4 5 0 90 4 5 0 90 4 3 3 93 6 3 3 93 6 3 3 93 6 3 3 93 6 3 3 93 6 3 3 93 6 1 6 96 8 1 6 96 8 1 6 96 8 1 6 96 8 1 6 96 8 1 6 96 8 1 6 96 8 1 6 96 8 1 6 96 8 1 6 96 8 1 6 96 8 1 6 96 8 0 0 0

1 0 1 8 0 81 0 1 8 0 81 0 1 8 0 81 0 1 8 0 81 0 1 8 0 81 0 1 8 0 81 0 1 8 0 81 0 1 8 0 8 5 09 0 4 5 09 0 4 5 09 0 4 5 09 0 4 5 09 0 4 5 09 0 4 5 09 0 4 5 09 0 4 5 09 0 4 3 39 3 6 3 39 3 6 3 39 3 6 3 39 3 6 2 54 5 2 2 54 5 2 2 54 5 2 2 54 5 2 2 54 5 2 2 54 5 2 2 03 6 1 2 03 6 1 2 03 6 1 1 69 6 8 1 69 6 8 1 69 6 8 1 45 4 4 1 45 4 4 1 45 4 4 1 27 2 6 1 27 2 6 1 27 2 6

51 2 10 2 4 15 3 6 20 4 8 25 6 0 30 7 2 35 8 4* 40 9 6 46 0 8 51 2 0 56 3 2 61 4 4 61 5 6 66 5 6 71 6 8 76 8 0 81 9 2 87 0 4 92 1 6 à122 88128 00 à143 36148 48 à163 84168 96 à204 80209 92 à245 76250 88 à286 72291 84 à327 68

-82 ,35 %-71 ,43 %-60 ,00 %-50 ,00 %-40 ,00 %-25 ,00 %-14 ,29 % 0 ,0 0 %-40 ,00 %-40 ,00 %-25 ,00 %-25 ,00 %-25 ,00 %-25 ,00 % 0 ,0 0 % 0 ,0 0 % 0 ,0 0 %-33 ,33 % 0 ,0 0 % 0 ,0 0 % 0 ,0 0 %-25 ,00 %-25 ,00 %-25 ,00 % 5 0 ,00 % 5 0 ,00 % 5 0 ,00 % 2 0 ,00 % 2 0 ,00 % 2 0 ,00 % 0 ,0 0 % 0 ,0 0 % 0 ,0 0 %-14 ,29 %-14 ,29 %-14 ,29 % - " -

MS/D500

* Valeur implicite pour FILALLOC

Nombre de CI


6-10 47 F2 04UF Rev04

Tableau 6-5. Capacité respective des volumes VBO et FBO sur disques MS/B10

Tableau 6-5. Capacité respective des volumes VBO et FBO sur disques MS/B10

N om bre de C IV BO FB OC ISIZE

D iffé rence (enpourcen tage )

* Va leur im p lic ite pou r F ILAL LO C

2 07 60 02 07 60 02 07 60 02 07 60 02 07 60 02 07 60 02 07 60 02 07 60 01 03 80 01 03 80 01 03 80 01 03 80 01 03 80 01 03 80 01 03 80 01 03 80 01 03 80 0 69 200 69 200 69 200 69 200 51 900 51 900 51 900 41 520 41 520 41 520 41 520 34 600 34 600 29 657 29 657 25 950 25 950

10 38 00 0 6 7 4 7 0 0 4 9 3 0 5 0 3 8 9 2 5 0 3 3 7 3 5 0 2 8 5 4 5 0 2 3 3 5 5 0 2 0 7 6 0 0 1 8 1 6 5 0 1 8 1 6 5 0 1 5 5 7 0 0 1 5 5 7 0 0 1 5 5 7 0 0 1 2 9 7 5 0 1 2 9 7 5 0 1 0 3 8 0 0 1 0 3 8 0 0 1 0 3 8 0 0 1 0 3 8 0 0 7 7 8 5 0 7 7 8 5 0 7 7 8 5 0 5 1 9 0 0 5 1 9 0 0 5 1 9 0 0 5 1 9 0 0 2 5 9 5 0 2 5 9 5 0 2 5 9 5 0 2 5 9 5 0 2 5 9 5 0 2 5 9 5 0 2 5 9 5 0 2 5 9 5 0

-8 0 ,0 0 %-6 9 ,2 3 %-5 7 ,8 9 %-4 6 ,6 7 %-3 8 ,4 6 %-2 7 ,2 7 %-1 1 ,1 1 % 0 ,0 0%-4 2 ,8 6 %-4 2 ,8 6 %-3 3 ,3 3 %-3 3 ,3 3 %-3 3 ,3 3 %-2 0 ,0 0 %-2 0 ,0 0 % 0 ,0 0% 0 ,0 0%-3 3 ,3 3 %-3 3 ,3 3 %-1 1 ,1 1 %-1 1 ,1 1 %-3 3 ,3 3 % 0 ,0 0% 0 ,0 0%-2 0 ,0 0 %-2 0 ,0 0 % 6 0 ,0 0% 6 0 ,0 0% 3 3 ,3 3% 3 3 ,3 3% 1 4 ,2 9% 1 4 ,2 9% 0 ,0 0% 0 ,0 0%

5 12 1 0 24 1 5 36 20 48* 2 5 60 3 0 72 3 5 84 4 0 96 4 6 08 5 1 20 5 6 32 6 1 44 6 1 56 6 6 56 7 1 68 7 6 80 8 1 92 8 7 04 9 2 16 9 7 28122 88128 00133 12163 84168 96194 56199 68204 80209 92245 76250 88286 72291 84327 68

MS/B10


47 F2 04UF Rev04 6-11

6.3.4 Taille initiale du fichier (paramètre SIZE ou SPLIT)

Comme indiqué précédemment, il existe deux modes d'affectation de l'espace initial :

Avec la commande BUILD_FILE (équivalent JCL = PREALLOC), la commandeCREATE_FILE (équivalent JCL = FILALLOC), le groupe de paramètres ALCn (équivalentJCL = ALLOCATE) ou le paramètre DYNALC (équivalent JCL = OUTALC), l'utilisateurpeut employer le paramètre SIZE pour demander une affectation globale : il spécifie lataille voulue et le système effectue la répartition dans un ou plusieurs volumes désignéspar le paramètre FILE, en fonction de l'espace disponible.

Avec la commande BUILD_FILE uniquement, l'utilisateur a également la possibilitéd'employer le paramètre SPLIT (au lieu de SIZE) pour demander une affectationfractionnée (volume par volume) : il indique la quantité d'espace à affecter dans chaquevolume qu'il spécifie, avec éventuellement une adresse début (cylindre/piste). Dans cecas, il doit obligatoirement associer le paramètre SPLITDVC à SPLIT pour désigner laclasse d'appareils. Avec SPLIT, il ne peut y avoir qu'un seul fragment affecté au fichierpar volume et l'utilisateur ne peut spécifier UNIT = CI ou RECORD.

La taille initiale demandée doit être :

• inférieure à 32 768 si UNIT = 100KB, TRACK ou CYL,• inférieure à 16 777 216 si UNIT = BLOCK ou CI,• inférieure à 2 130 706 306 si UNIT = RECORD.

Les fichiers séquentiels et séquentiels indexés pouvant faire l'objet d'extensionsautomatiques, l'utilisateur n'a à spécifier pour ces fichiers que l'espace requis à lacréation. A noter que pour les applications TDS, de trop fréquentes extensions de fichierssont coûteuses.


6-12 47 F2 04UF Rev04

6.3.5 Taille d'incrément (paramètre INCRSIZE)

Le paramètre INCRSIZE permet de spécifier la taille d'incrément à utiliser pour l'extensiondynamique (automatique) du fichier, chaque fois que celui-ci sera plein. La valeur deINCRSIZE est exprimée en cylindres, pistes, CI, articles, blocs ou quanta de 100 Ko,selon l'option choisie dans le paramètre UNIT. Pour les fichiers sur disques FSA, il estrecommandé de spécifier UNIT = BLOCK ou UNIT = 100KB (voir plus loin dans cechapitre).

Le paramètre INCRSIZE est utilisable dans les commandes BUILD_FILE (équivalent JCL= PREALLOC), CREATE_FILE (équivalent JCL = FILALLOC) ou dans le groupe deparamètres ALCn (équivalent JCL = ALLOCATE). La valeur de INCRSIZE ne remplacepas une valeur (autre que zéro) déjà déclarée dans le catalogue, ou fixée ultérieurementau moyen de MODIFY_FILE (CATMODIF). En cas de conflit, c'est toujours la valeur nonnulle du catalogue qui est retenue.

La valeur implicite de INCRSIZE est 0 (pas d'extension automatique), et sa valeurmaximum 32 767.

La valeur de INCRSIZE doit être suffisante pour limiter le nombre d'extensionsnécessaires. En principe, l'estimation initiale doit être correcte, mais si une extensions'avère nécessaire, l'incrément doit être assez important (20 à 30% de la valeur spécifiéepour SIZE à la création du fichier).

Pour effectuer une extension statique, l'utilisateur dispose de la commande GCLMODIFY_FILE_SPACE avec le paramètre SIZE (voir plus loin dans ce chapitre), ou del'ordre JCL PREALLOC avec le paramètre EXTEND.


47 F2 04UF Rev04 6-13

6.4 SIMULATION D'AFFECTATION DE PLACE À UN FICHIER

Il est possible de simuler une réservation de place pour un fichier au moyen de lacommande CREATE_FILE (voir plus loin dans ce chapitre pour la syntaxe). Cetteopération présente l'avantage d'être simple et rapide. L'utilisateur évalue d'abordglobalement la taille de fichier nécessaire (par exemple), puis affine progressivement sesévaluations. Il ne perd plus de temps à calculer le nombre de CI nécessaires pour lecontenu de l'espace adresses 1 ou pour les index (dans le cas d'un fichier séquentielindexé).

En mode ligne, vérifier que le paramètre IMMED est à 0, pour pouvoir modifier lescaractéristiques du modèle (de fichier) au moyen des commandes appropriées. Sil'utilisateur ne spécifie rien, les valeurs implicites s'appliquent pour :

• FILEFORM• FILEORG• RECFORM• CISIZE• RECSIZE• UNIT• SIZE• INCRSIZE

La commande REPORT permet de visualiser les caractéristiques "courantes" du fichier àcréer. Se reporter au manuel de référence de l'utilisateur IOF pour plus de détails surcette commande.


6-14 47 F2 04UF Rev04

6.5 CALCULS D'ESPACE POUR UN FICHIER SEQUENTIEL

Les notions de base sur les fichiers séquentiels sont indispensables à la compréhensiondes calculs décrits ici. Ces notions sont définies au chapitre 2

Les éléments nécessaires aux calculs sont les suivants :

• RECSIZE (déterminé par le programme utilisateur),

• CISIZE (choisi par le concepteur du fichier),

• Nombre d'articles à enregistrer dans le fichier.

Pour un fichier séquentiel, la valeur de CISIZE doit être comprise dans les limitessuivantes :

• fichiers VBO : CISIZE doit être supérieur ou égal à (RECSIZE + 12), et ne peut excéder1 piste,

• fichiers FBO : CISIZE doit être supérieur ou égal à (RECSIZE + 14).

6.5.1 Articles de longueur fixe

Si l'utilisateur connait déjà le nombre d'articles du fichier à créer, il lui suffit de spécifierUNIT = RECORD dans la commande BUILD_FILE : Le système effectue alorsautomatiquement la réservation de place. Dans le cas contraire, l'utilisateur doit avoirrecours à l'utilitaire de CREATE_FILE ou effectuer les calculs suivants :

Calcul du nombre d'articles par CI :

Nombre d'articles par CI =

(CISIZE - en-tête CI) divisé par (RECSIZE + 4)

arrondi à l'entier inférieur

Longueur de l'en-tête de CI :

• 10 octets sur les disques FSA ;

• 8 octets sur les disques non-FSA.

4 (octets) correspond à l'en-tête d'article.


47 F2 04UF Rev04 6-15

Calcul du nombre de CI requis :

Nombre de CI =

(nb total d'articles) divisé par (nb d'articles par CI)

arrondi à l'entier supérieur

Si la réservation d'espace est effectuée par BUILD_FILE avec UNIT = CI ou RECORD, lenombre de CI ainsi calculé est suffisant car la piste devant contenir l'espace adresses 1est ajoutée automatiquement par le système.

(disques non-FSA uniquement) Si UNIT = TRACK ou CYL, il faut calculer le nombre depistes (et éventuellement de cylindres à partir de ce nombre) :

Nb de pistes =

(Nb total de CI) divisé par (Nb CI par piste) + 1


La piste supplémentaire est nécessaire pour l'espace adresses 1 (alors que si UNIT = CIou RECORD, elle est ajoutée automatiquement par le système).

Le nombre de CI par piste est indiqué au tableau 6-1.

Exemple FBO :

Soit un fichier séquentiel PK.LOP de 2 349 articles d'une longueur de 220 octets chacun,à implanter dans un volume MS/FSA.

D'après une simulation (voir plus loin dans ce chapitre) le nombre de blocs nécessairesest de 90.

CREATE_FILE PK.LOP:VOL1:MS/FSA FILESTAT = CAT UFAS = SEQ UNIT = BLOCK SIZE = 90 CISIZE = 6144 RECFORM = F RECSIZE = 220;

Exemple VBO

Soit un fichier séquentiel PC.WTM de 3 000 articles d'une longueur de 90 octets chacun àimplanter dans le volume BD18 sur MS/D500. La taille de CI est de 4 096 octets.

La méthode la plus simple consiste à spécifier UNIT = RECORD et SIZE=3000 dans lacommande BUILD_FILE. UFAS-EXTENDED calcule ensuite automatiquement le nombrede pistes nécessaires.

Dans les autres cas, l'utilisateur doit avoir recours à l'utilitaire CREATE_FILE ou effectuerles calculs suivants :

Nb d'articles par CI = (4096 - 8) divisé par (90 + 4) = 43

Nb de CI de données = 3000 divisé par 43 = 70


6-16 47 F2 04UF Rev04

Avec une taille de CI de 4096, il y a six CI par piste (voir tableau 6-1, colonne MS/D500).

Nb de pistes = (70 divisé par 6) + 1 = 13

La commande BUILD_FILE est la suivante :

BUILD_FILE PC.WTM:BD18:MS/D500 FILESTAT = CAT UFAS = SEQ UNIT = CI (ou UNIT = TRACK ou UNIT = CYL SIZE = 70 SIZE = 13 SIZE = 1 ) CISIZE = 4096 RECSIZE = 90;

D'après le tableau 6-3, un cylindre MS/D500 contient 24 pistes et sera donc suffisant pourles 13 pistes du fichier PC.WTM.


47 F2 04UF Rev04 6-17

6.5.2 Articles de longueur variable

Le mode de calcul est le même que pour les articles de longueur fixe, mais avec unelongueur moyenne d'article (lma) au lieu d'une longueur fixe (RECSIZE).


(CISIZE - en-tête CI) divisé par (lma + 4)


Nombre de CI =

(Nb total d'articles) divisé par (Nb articles par CI)


Nombre de pistes =

(Nb total de CI) divisé par (Nb CI par piste) plus 1


Exemple FBO :

Soit un fichier séquentiel PK.RIT de 2000 articles de longueur variable (longueurmoyenne 25 octets et longueur maximum 98 octets), à implanter dans un volumeMS/FSA. La taille de CI est de 3584 octets.

Nombre d'articles par CI = (3584 - 10) divisé par (25 + 4) = 123,24 = 123

Nombre de CI de données = 2000 divisé par 123 = 16,23 = 17

Ajouter à ce résultat 5 CI pour l'espace adresses 1, ce qui donne au total 22 CI. A noterqu'il est toujours possible de modifier cette estimation au moyen de CREATE_FILE (voirprécédemment) :

CRF PK.RIT:PKT:MS/FSA FILESTAT = CAT UFAS = SEQ UNIT = BLOCK SIZE = 22 CISIZE = 3584 RECFORM = V RECSIZE = 98;


6-18 47 F2 04UF Rev04

Exemple VBO :

Soit un fichier séquentiel PC.VWT de 4500 articles de longueur variable (longueurmoyenne 40 octets et longueur maximum 120 octets), à implanter dans le volume MX42sur MS/D500. La taille de CI est de 1536 octets.

Nombre d'articles par CI = (1536 - 8) divisé par (40 + 4) = 34

A noter que si UNIT = RECORD (avec SIZE = 4500), l'utilisateur doit spécifier une tailled'article de 120 (au lieu de 40).

Nombre de CI = 4500 divisé par 34 = 133

Avec une taille de CI de 1536, il y a 15 CI par piste (voir tableau 6-1 colonne MS/D500).

Nombre de pistes = (133 divisé par 15) + 1

= 9,86 arrondi à l'entier supérieur = 10


BUILD_FILE PC.VWT:MX42:MS/D500 FILESTAT = CAT UFAS = SEQ UNIT = CI (ou UNIT = TRACK ou UNIT = CYL SIZE = 133 SIZE = 10 SIZE = 1 ) CISIZE = 1536 RECSIZE = 120 RECFORM = V;


47 F2 04UF Rev04 6-19

6.6 CALCULS D'ESPACE POUR UN FICHIER RELATIF

Les notions de base sur les fichiers relatifs sont indispensables à la compréhension descalculs décrits ici. Ces notions sont définies au chapitre 3.

Les éléments nécessaires aux calculs sont les suivants :

• RECSIZE (déterminé par le programme utilisateur),

• CISIZE (choisi par le concepteur du fichier),

• Nombre d'articles à enregistrer dans le fichier.

Pour un fichier relatif, le format des articles (fixe ou variable) n'a pas d'incidence sur lemode de calcul. D'autre part, la valeur de CISIZE doit être comprise dans les limitessuivantes :

• fichiers FBO : CISIZE doit être supérieur ou égal à (RECSIZE + 14).

• fichiers VBO : CISIZE doit être supérieur ou égal à (RECSIZE + 12), et ne peut excéder1 piste.

La méthode la plus simple consiste à spécifier UNIT = RECORD et SIZE = nombred'articles dans la commande BUILD_FILE. UFAS-EXTENDED calcule ensuiteautomatiquement le nombre de blocs/pistes nécessaires.

Dans les autres cas, l'utilisateur doit avoir recours à la commande REPORT deCREATE_FILE, ou effectuer les calculs suivants :

1. Calcul du nombre d'articles par CI :


(CISIZE - en-tête CI) divisé par (RECSIZE + 4) arrondi à l'entier inférieur


• 8 octets pour les fichiers VBO ;

• 10 octets pour les fichiers FBO (9 + 1 octet de fin).

4 (octets) correspond à l'en-tête d'article.


6-20 47 F2 04UF Rev04

2. Calcul du nombre de CI requis :

Nombre de CI =

(Nb total d'articles) divisé par (Nb articles par CI)


3. Pour les volumes VBO, calculer le nombre de pistes :

Nombre de pistes =

(Nb total de CI ) divisé par (Nb CI par piste) plus 1


(La piste supplémentaire correspond à l'espace adresses 1.)

Exemple FBO

Soit un fichier relatif POR.CL de 4510 articles d'une longueur de 112 octets chacun, àimplanter dans le volume RR1 sur MS/FSA. La taille de CI est de 4608 octets. L'unitéd'affectation est le bloc.



Ajouter à ce résultat 5 CI pour l'espace adresses 1, ce qui donne au total 121 CI, àspécifier dans le paramètre SIZE. A noter qu'il est toujours possible de modifier cettevaleur en effectuant une simulation au moyen de CREATE_FILE (voir précédemment) :

CRF POR.CL:RR1:MS/FSA FILESTAT = CAT UFAS = RELATIVE UNIT = CI SIZE = 121 CISIZE = 4608 RECSIZE = 112;

Exemple VBO

Soit un fichier relatif CLX.AA de 2.080 articles d'une longueur de 134 octets chacun, àimplanter dans le volume 26P sur MS/D500. La taille de CI est de 2560 octets.



Une piste peut contenir 10 CI de 2560 octets (voir tableau 6-1, colonne MS/D500).


47 F2 04UF Rev04 6-21

Nombre de pistes = (116 divisé par 10) plus 1

arrondi à l'entier supérieur = 13


BF CLX.AA:26P:MS/D500 FILESTAT = CAT UFAS = RELATIVE UNIT = CI ou ( UNIT = TRACK ou UNIT = CYL SIZE = 116 SIZE = 13 SIZE = 1 ) CISIZE = 2560 RECSIZE = 134;

D'après le tableau 6-3, un cylindre MS/D500 contient 24 pistes et sera donc suffisant pourles 13 pistes du fichier CLX.AA. Ainsi, 11 pistes sont inutilisées lorsque UNIT = CYL. Parconséquent il est préférable de spécifier UNIT = TRACK.

Les calculs sont les mêmes quel que soit le format des articles (fixe ou variable).


6-22 47 F2 04UF Rev04

6.7 PARAMETRAGE DES FICHIERS SEQUENTIELS INDEXES

Les notions de base sur les fichiers séquentiels indexés sont indispensables à lacompréhension de ce paragraphe. Ces notions sont définies au chapitre 4.

Le paramétrage d'un fichier indexé présentant une certaine complexité, il estrecommandé de ne pas passer trop rapidement sur cette partie.

Pour la réservation d'espace, l'utilisateur doit spécifier les valeurs suivantes :

CISIZE taille (en octets) de CI (de données, d'index, de label), pour legroupe de paramètres ALCn.

CIFSP espace libre à laisser par CI (en pourcentage)

SIZE taille initiale du fichier :(UNIT = BLOCK, 100KB, CYL ou RECORD) pour les fichiersFBO.

(UNIT = CI, TRACK, CYL ou RECORD) pour les fichiersVBO.

CIFSP a une valeur implicite de 0. Si l'utilisateur souhaite l'extension automatique dufichier, il doit spécifier la taille de l'incrément dans le paramètre INCRSIZE de lacommande BUILD_FILE ou CREATE_FILE, ou du groupe de paramètres ALCn. Leséquivalents JCL de ces commandes sont les utilitaires PREALLOC et FILALLOC, leparamètre OUTALC et l'ordre ALLOCATE.

Le mode d'accès a une influence déterminante sur les temps d'accès.

En accès direct, les performances sont constantes pendant toute la durée de vie dufichier.

Les performances dépendent du facteur de groupage , c'est-à-dire du nombre d'articlespar CI. Sa valeur doit obligatoirement être supérieure ou égale à 2.

Facteur de groupage = (CISIZE - en-tête CI)

divisé par RECSIZE + 7

7 (octets) correspond à la longueur de l'en-tête d'article (5 octets) plus celle dudescripteur d'article (2 octets).

L'en-tête de CI a une longueur de 21 octets (+ 1 octet pour le label fin de CI) pour lesfichiers FBO, et de 20 octets pour les fichiers VBO (voir figure 4-13).


47 F2 04UF Rev04 6-23

6.7.1 Taille de CI (paramètre CISIZE) pour un fichier séquentiel indexé

Le choix de la taille de CI dépend du type d'application à exécuter. Pour une applicationTDS, la taille de CI doit correspondre à 2 niveaux d'index maximum. Le nombre derubriques d'index se calcule comme suit :

• Clé primaire

Nombre de rubriques par CI d'index = (CISIZE - 10) divisé par (KEYSIZE + 4)

• Clé secondaire

Nombre de rubriques par CI d'index = (CISIZE - 10) divisé par (KEYSIZE + 8)

Pour limiter à 2 le nombre de niveaux d'index, s'assurer que le nombre de rubriques parindex est supérieur à la racine carrée du nombre de CI du fichier. Si ce n'est pas le cas,augmenter la taille de CI afin de réduire le nombre de CI de données et d'index.

La taille de CI doit être suffisante pour contenir au moins deux articles. Elle doit être fixéedans les limites suivantes :

• Fichiers VBO :

Longueur de piste >= CISIZE >= 2 * (RECSIZE + 7) + en-tête CI

• Fichiers FBO :

CISIZE >= 2 * (RECSIZE + 7) + en-tête CI

Une taille de CI d'environ 4 Ko offre une bonne efficacité. De même, essayer de choisirun facteur de groupage compris entre les limites suivantes :

10 <= facteur de groupage <= 255

sachant que :

facteur de groupage = (CISIZE - en-tête CI) divisé par (RECSIZE + 7)


6-24 47 F2 04UF Rev04

6.7.2 Espace libre par CI (paramètre CIFSP)

Le paramètre CIFSP permet de spécifier le pourcentage d'espace libre à laisser danschaque CI au chargement initial du fichier. Cet espace permet par la suite d'insérer desarticles sans entraîner de réorganisations incrémentales de CI. Il doit être suffisammentgrand pour contenir un article ou un nombre entier d'articles. Par exemple, s'il y a 10articles par CI, l'utilisateur peut spécifier 20 % d'espace libre pour permettre l'insertionultérieure de 2 articles.

A noter que le paramètre CIFSP du groupe de paramètres DEFn (équivalent JCL =DEFINE) n'est utilisable qu'à la création du fichier.

Si l'utilisateur crée un fichier séquentiel dans lequel il ne prévoit aucune insertion, il doitattribuer la valeur 0 au paramètre CIFSP de la commande BUILD_FILE.

S'il envisage des insertions réparties sur l'ensemble du fichier, il peut spécifier une valeurproche de 20.

Si les insertions sont concentrées en un même endroit du fichier, l'utilisateur n'a pas àemployer CIFSP.

Figure 6-1. Exemple d'utilisation de CIFSP

Exemple :

C I au ch a rg em en tin it ia l

A la c ré a tio n du fich ie r, l'u tilisa te u rsp é c ifie C IF S P = 20 (2 0% d 'espa celib re pa r C I).A u cha rg em e n t in it ia l, le f ich ie r e s t do ncrem p li à 8 0% .

C I a p rè s ins e rt ion s

80% d 'e spaceoccupé

20% d 'e spacelib re

90% d 'e spaceoccupé

10% d 'e spacelib re

A p rè s in se rtion s en m o d e I-O ,le fich ie r e st p le in à 9 0 % e t co m p ortedo nc e nco re 1 0% d 'esp a ce lib re .

Figure 6-1. Exemple d'utilisation de CIFSP

Le maximum d'espace libre s'obtient en chargeant un seul article par CI, c'est-à-dire enspécifiant CIFSP = 100. Il est possible de calculer le pourcentage d'espace libre avec unseul article par CI ; toute valeur comprise entre ce pourcentage et 100 équivaut à spécifier100.


47 F2 04UF Rev04 6-25

Dans le cas d'un fichier volatile, le paramètre CIFSP peut être utile pour réduire le nombreimportant de réorganisations incrémentales (de CI).

Lorsque l'unité d'affectation est l'article (UNIT = RECORD), le nombre d'articles spécifiédans le paramètre SIZE correspond au nombre d'articles à charger initialement. Si CIFSPest spécifié, UFAS-EXTENDED calcule automatiquement la quantité d'espace libre àprévoir par CI pour permettre l'insertion ultérieure d'articles. Si l'on a par exemple :

UNIT = RECORD

SIZE = 1000

CIFSP = 20

UFAS-EXTENDED réserve de l'espace pour un fichier de 1000 articles, avec 20 %d'espace libre par CI.

Avec les autres unités d'affectation, le système réserve la quantité d'espace demandée.

6.7.3 Insertion de masse

L'insertion de masse consiste en l'adjonction séquentielle d'articles à la fin (dans l'ordrecroissant des clés) ou au début (dans l'ordre décroissant des clés) d'un fichier ouvert enmode I-O. Dans le premier cas, les valeurs de clés des nouveaux articles doivent êtresupérieures à la valeur de clé la plus élevée du fichier. Dans le second cas, les valeurs declés des nouveaux articles doivent être inférieures à la valeur de clé la moins élevée dufichier.

IMPORTANT :

A noter qu'en cas d'insertion de masse, UFAS-EXTENDED ne prend pas en compte leparamètre CIFSP du groupe DEFn (équivalent JCL = DEFINE), et crée autant de CIpleins que nécessaire.

6.7.4 Fichiers avec clés secondaires

En règle générale, éviter d'utiliser des index secondaires. Dans le cas d'une applicationTDS, ne pas en spécifier plus de 3.


6-26 47 F2 04UF Rev04

6.7.5 Calculs d'espace

Il est possible d'éviter ces calculs en utilisant la commande CREATE_FILE, qui permet desimuler une réservation d'espace pour un fichier (voir précédemment).

Si UNIT = CI ou RECORD (commande BUILD_FILE avec SIZE uniquement), l'utilisateurdoit disposer des éléments suivants :

• Taille de CI (CISIZE), en octets,

• Longueur d'article (RECSIZE), en octets,

• Nombre d'articles à enregistrer dans le fichier,

• Longueur de la zone clé, en octets.Lorsque UNIT = CI, il doit ensuite calculer le nombre total de CI pour pouvoir définir la taille initiale du fichier (paramètre SIZE).

Si UNIT = TRACK ou CYL , procéder de même, en calculant la taille du fichier en pistesou en cylindres pour le paramètre SIZE (ou éventuellement SPLIT dans BUILD_FILE).

La taille de CI doit être suffisante pour contenir au moins 2 articles. Le nombre maximumd'articles par CI de données est 255.

Lorsque les articles sont de format variable, c'est leur longueur moyenne qui doit êtreutilisée dans les calculs, mais c'est la longueur maximale qui est à spécifier dans leparamètre RECSIZE de la commande BUILD_FILE.

Le format d'un CI est représenté à la figure 4-13.

Les résultats doivent être arrondis à l'entier le plus proche (inférieur ou supérieur selon lecas). Si nécessaire, CISIZE est automatiquement arrondi par le système au multiple de512 immédiatement supérieur.

6.7.5.1 Fichiers sans index secondaires

La méthode de calcul dépend de l'unité d'affectation spécifiée dans le paramètre UNIT(RECORD, CI, CYL, TRACK, BLOCK ou 100KB).

Pour les fichiers FBO, il est préférable de spécifier UNIT = BLOCK ou UNIT = 100KB. Anoter que ces unités ne sont pas utilisables avec des fichiers VBO.


47 F2 04UF Rev04 6-27

Si UNIT = RECORD (commande BUILD_FILE uniquement)

L'utilisateur spécifie directement la taille du fichier en nombre d'articles dans le paramètreSIZE. La conversion en espace disque est effectuée à l'exécution par UFAS-EXTENDED.

Remarque : Si UNIT = CI, CYL ou TRACK, certains calculs sont nécessaires, saufsi l'on utilise la commande REPORT de CREATE_FILE.

Si UNIT = CI (commande BUILD_FILE uniquement)

L'utilisateur spécifie la taille du fichier en nombre de CI dans le paramètre SIZE. Sesinformations de base sont les suivantes :

• Nombre d'articles à enregistrer dans le fichier ;

• RECSIZE, c'est-à-dire la longueur d'article (en octets) ; pour les articles de formatvariable, c'est la longueur moyenne qui est à utiliser pour les calculs ;

• CISIZE, c'est-à-dire la taille (en octets) des CI de données, de label et d'index ;

• KEYSIZE, c'est-à-dire la longueur de la zone clé (en octets).L'utilisateur peut réserver de l'espace pour un fichier VBO au format UFAS (VERSION= PREVIOUS), mais ce uniquement au moyen de PREALLOC. Voir annexe F pourplus de détails.

Pour créer un fichier, la solution la plus simple consiste à utiliser BUILD_FILE avec UNIT= RECORD et SIZE = nombre d'articles. UFAS-EXTENDED calcule ensuiteautomatiquement :

• le nombre de blocs nécessaires (pour un fichier FBO),

• le nombre de pistes nécessaires (pour un fichier VBO).Dans tous les autres cas, utiliser la commande REPORT de CREATE_FILE oueffectuer les calculs suivants :

1. Nombre d'articles par CI :

Nombre d'articles par CI = (CISIZE - en-tête CI) divisé par (RECSIZE + 7)


2 <= Nb d'articles par CI <= 255


• 22 octets pour les fichiers FBO,

• 20 octets pour les fichiers VBO.

2. Nombre de CI de données dans le fichier :

(Nb total d'articles) divisé par (Nb d'articles par CI)



6-28 47 F2 04UF Rev04

Ces calculs effectués, l'utilisateur peut compléter le paramétrage de sa commandeBUILD_FILE. La conversion en espace disque est effectuée à l'exécution par UFAS-EXTENDED.

Exemple FBO :

Soit le fichier ED.BRT à implanter dans le volume VOL8 sur MS/FSA. L'unité d'affectationest le bloc (UNIT = BLOCK).

Les informations de base sont les suivantes :

• Nombre d'articles à enregistrer dans le fichier = 7.436

• RECSIZE = 230 octets

• CISIZE = 3584 octets

• KEYSIZE = 15 octets

• KEYLOC = 6 (début de la clé au 6ème octet de l'article)Nombre d'articles par CI

= (3584 - 22) divisé par (230 + 7) = 15

Nombre de CI = 7436 divisé par 15

= 496 arrondi à l'entier supérieur

D'après une simulation (au moyen de CREATE_FILE) le nombre de blocs nécessaires estde 505. Les données occupent 496 blocs, et 9 autres blocs sont réservés auxinformations de gestion (y compris l'index primaire). Une taille de 505 blocs est suffisantepour contenir 7436 articles.

CRF ED.BRT:VOL8:MS/FSA EXPDATE = 450 FILESTAT = CAT UFAS = INDEXED UNIT = BLOCK SIZE = 505 CISIZE = 3584 RECSIZE = 230 KEYLOC = 6 KEYSIZE = 15;


47 F2 04UF Rev04 6-29

Exemple VBO :

Soit le fichier JC.EXM à implanter dans le volume TNDA sur MS/D500. L'unitéd'affectation est le CI (UNIT = CI).

Les informations de base sont les suivantes :

• Nombre d'articles à enregistrer dans le fichier = 5060

• RECSIZE = 200 octets

• CISIZE = 4096 octets (le tableau 6-1 indique que dans ce cas, il y a 6 CI de données par piste sur MS/D500).

• KEYSIZE = 10 octets

• KEYLOC = 5 (début de la clé au 5ème octet de l'article).Les calculs permettant d'obtenir le nombre de CI de données sont les suivants :

Nombre d'articles par CI = (4096 - 20) divisé par (200 + 7)

= 19,69

= 19 arrondi à l'entier inférieur

Nombre de CI de données = 5060 divisé par 19


Les 267 CI de données sont enregistrés dans l'espace adresses 2. Les espaces adresses1, 3 et 4 étant gérés par le système, l'utilisateur n'a pas à intervenir.

La commande BUILD_FILE pourra se présenter comme suit :

BUILD_FILE JC.EXM:TNDA:MS/D500 EXPDATE = 199 FILESTAT = CAT UFAS = INDEXED UNIT = CI (ou UNIT = RECORD et SIZE = 5060) SIZE = 267 CISIZE = 4096 RECSIZE = 200 KEYLOC = 5 KEYSIZE = 10;


6-30 47 F2 04UF Rev04


A noter qu'il est préférable de réserver ces unités d'affectation aux fichiers implantés surdes disques non-FSA.

Lorsqu'il spécifie UNIT = CYL ou TRACK, l'utilisateur doit connaître exactement lenombre de cylindres ou de pistes nécessaires à son fichier, alors qu'avec UNIT =RECORD ou CI, il indique simplement un nombre d'articles ou de CI et c'est UFAS-EXTENDED qui assure la conversion en espace disque.

Pour déterminer le nombre de pistes requis, la meilleure méthode consiste à faireeffectuer le calcul par le processeur CREATE_FILE en simulant la création du fichier (voirprécédemment).

Lorsque UNIT = CYL, l'utilisateur peut convertir le nombre de pistes en nombre decylindres, comme suit :

Nombre de cylindres =

(Nb total de pistes) divisé par (Nb de pistes par cyl.)


Une fois connu le nombre de cylindres (ou de pistes), il est possible de créer le fichier àl'aide de BUILD_FILE.

Les paramètres obligatoires sont les suivants :

SIZE ou SPLIT taille du fichier (globale ou répartie), en cylindres ou pistes.RECSIZE longueur d'article, en octets (UFAS-EXTENDED prend en

compte la longueur maximale spécifiée pour les articles deformat variable).

CISIZE taille de CI, en octetsKEYSIZE longueur de la clé primaire, en octets.KEYLOC octet début de la clé primaire dans l'article (le premier octet

de l'article occupe la position 1).Exemple :

Soit le fichier JC.EXN à implanter dans le volume TNDA sur MS/D500, avec UNIT =TRACK.

Informations de base :

Nombre de pistes = 95

RECSIZE = 200 octets

CISIZE = 5120 octets

KEYSIZE = 20 octets

KEYLOC = 53Le tableau 6-1. indique qu'avec CISIZE = 5120, il y a 5 CI par piste sur MS/D500.


47 F2 04UF Rev04 6-31

La commande BUILD_FILE se présente donc comme suit :

BF FILE = JC.EXN:TNDA:MS/D500 FILESTAT = CAT EXPDATE = 199 UFAS = INDEXED UNIT = TRACK SIZE = 95 CISIZE = 5120 RECSIZE = 200 KEYSIZE 20 KEYLOC = 53;

Le nombre d'articles du fichier s'obtient par la commande CREATE_FILE (équivalent JCL= FILALLOC), et la place allouée à chaque espace adresses par la commandeLIST_FILE. Le nombre d'articles s'obtient en multipliant le nombre de CI par le nombred'articles par CI.

6.7.5.2 Fichiers avec index secondaires

Les index secondaires sont rangés dans les espaces adresses 5, 6 et 7. La réservationd'espace s'effectue de la même manière que pour les espaces adresses 2, 3 et 4respectivement, à ceci près qu'il doit être tenu compte du nombre d'index secondaires.Comme pour les fichiers sans index secondaires, l'unité d'affectation peut être le bloc(BLOCK) ou le quantum de 100 Ko (100KB), ou encore l'article (RECORD) pour lesfichiers FBO. Il est préférable de n'utiliser le cylindre (CYL), la piste (TRACK) et le CI (CI)que pour les fichiers qui sont implantés sur des disques VBO.

Si UNIT = RECORD (Commande BUILD_FILE uniquement)

L'utilisateur spécifie directement la taille du fichier en nombre d'articles dans le paramètreSIZE. La conversion en espace disque est effectuée à l'exécution par UFAS-EXTENDED.

Si UNIT = CI (Commande BUILD_FILE uniquement)

L'utilisateur spécifie la taille du fichier en nombre de CI dans le paramètre SIZE. Il doitdisposer des informations suivantes :

• Nombre d'articles à enregistrer dans le fichier,• RECSIZE, c'est-à-dire la longueur d'article (en octets) ; pour les articles de format

variable, c'est la longueur moyenne qui est à utiliser pour les calculs,• CISIZE, c'est-à-dire la taille de CI (en octets),• Clé primaire :

- KEYSIZE, c'est-à-dire la longueur de la clé primaire (en octets)

- KEYLOC, c'est-à-dire la position début de la clé primaire dans l'article,

• Clés secondaires :

Pour chaque clé secondaire, il doit connaître également sa longueur et sa positiondébut dans l'article.

Il peut y avoir jusqu'à 15 clés secondaires, à définir dans le paramètre SECIDX de lacommande BUILD_FILE.


6-32 47 F2 04UF Rev04

Le format de ce paramètre est le suivant :

SECIDX = (keyloc:keysize[:DUPREC]...)

Exemple :

SECIDX = (9:4:DUPREC)

Une seule clé secondaire. Elle commence à l'octet 9 et sa longueur est de 4 octets.DUPREC indique que tous les articles présentant une valeur identique pour cette clé sontacceptés. Lorsque :DUPREC est omis, si plusieurs articles présentent la même valeurpour cette clé, seul le premier sera admis dans le fichier.

La longueur maximum d'une clé secondaire est de 251 octets. Une clé doit toujours êtreentièrement contenue dans l'article ; sa longueur doit donc être telle que :

(KEYLOC + KEYSIZE) <= (RECSIZE + 1)

Une clé secondaire ne peut avoir la même position début qu'une autre clé (primaire ousecondaire). A cette restriction près, deux clés peuvent se chevaucher.

Exemple d'article avec deux clés secondaires :

C lé prim aire

C lé secondaire C lé secondaire

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

KEYSIZE (0) = 4 KEYLOC (0) = 1KEYSIZE (1) = 3 KEYLOC (1) = 3KEYSIZE (2) = 4 KEYLOC (2) = 9

Clé primaire :

Position début = 1

Longueur = 4

Clé secondaire 1 :

Position début = 3

Longueur = 3


47 F2 04UF Rev04 6-33

Clé secondaire 2 :

Position début = 9

Longueur = 4

Pour spécifier le paramètre SIZE dans la commande BUILD_FILE, l'utilisateur doitcalculer le nombre de CI de données du fichier, comme suit :

1. Nombre d'articles par CI :

(CISIZE - en-tête CI) divisé par (RECSIZE + 7)


L'en-tête de CI a une longueur de 22 octets (fichiers FBO) ou de 20 octets (fichiers VBO).

2. Nombre de CI de données dans le fichier :

(Nb total d'articles) divisé par (Nb d'articles par CI)


A l'exécution, UFAS-EXTENDED effectue la conversion en espace disque.

Remarque : Un exemple de vidage en hexadécimal du contenu des espacesadresses pour les fichiers séquentiels indexés est fourni à l'annexe C.

Exemple FBO :

Soit le fichier PK.NEY à implanter dans le volume VOL44 sur MS/FSA, avecUNIT = BLOCK.


Nombre d'articles à enregistrer dans le fichier = 3115



Clé primaire :

KEYLOC = 4 (Position début)

KEYSIZE = 14 (Longueur)


6-34 47 F2 04UF Rev04

Clés secondaires (à spécifier dans le paramètre SECIDX) :

Clé 1 :

Position début = 19

Longueur = 6

Clé 2 :


Longueur = 39

Clé 3 :


Longueur = 17

Clé 4 :


Longueur = 9

1. L'utilisateur doit calculer le nombre de CI de données du fichier comme suit :

Nombre d'articles par CI

= (4096 - 22) divisé par (108 + 7)


Nombre de CI de données = 3115 divisé par 35 = 89

2. Simuler la création du fichier au moyen de CREATE_FILE (voir précédemment). Evaluer globalement la taille du fichier, en tenant compte des blocs supplémentaires pour l'espace adresses 1 et les index primaire et secondaires.

Affiner ensuite l'estimation en modifiant la valeur de SIZE. A noter que le fichier doit avoir une taille minimum de 214 blocs pour pouvoir contenir 3115 articles.


47 F2 04UF Rev04 6-35

3. La commande CREATE_FILE se présentera comme suit :

CRF PK.NEY:VOL44:MS/FSA FILESTAT = CAT EXPDATE = 210 UFAS = INDEXED UNIT = BLOCK SIZE = 214 CISIZE = 4096 RECSIZE = 108 KEYLOC = 4 KEYSIZE = 14 SECIDX = (19:6 30:39 74:17 95:9);

Exemple VBO :

Soit le fichier JC.EXO à implanter dans le volume TNDA sur MS/B10, avec UNIT = CI.


Nombre d'articles à enregistrer dans le fichier = 2915



Clé primaire :

KEYLOC = 5 (Position début)

KEYSIZE = 20 (Longueur)

Clés secondaires (à spécifier dans le paramètre SECIDX) :

Clé 1 :


Longueur = 10

Clé 2 :


Longueur = 50

Clé 3 :


Longueur = 40, avec clé en double


6-36 47 F2 04UF Rev04

Clé 4 :



Le nombre d'articles étant connu, il est possible d'effectuer la réservation de placedirectement en articles (UNIT = RECORD).

Sinon, effectuer les calculs suivants pour obtenir le nombre de CI de données :

Nombre d'articles par CI = (3584 - 20) divisé par (200 + 7)

= 17,21


Nombre de CI = 2915 divisé par 17


La commande BUILD_FILE se présentera comme suit :

BF JC.EXO:TNDA:MS/B10 FILESTAT = CAT EXPDATE = 199 UFAS = INDEXED UNIT = CI (ou UNIT = RECORD et SIZE = 2915) SIZE = 172 CISIZE = 3584 RECSIZE = 200 KEYLOC = 5 KEYSIZE = 20 SECIDX = (30:10 45:50 96:40:DUPREC 138:30:DUPREC);

Le nombre d'articles du fichier s'obtient par la commande CREATE_FILE (équivalent JCL= FILALLOC), et la place allouée à chaque espace adresses par la commandeLIST_FILE. Le nombre d'articles se calcule en multipliant le nombre de CI par le nombred'articles par CI.


A noter qu'il est préférable d'utiliser ces unités de réservation uniquement pour les fichiersimplantés sur des disques non-FSA.

Lorsqu'il spécifie UNIT = CYL ou TRACK, l'utilisateur doit connaître exactement lenombre de cylindres ou de pistes nécessaires à son fichier, alors qu'avec UNIT =RECORD ou CI, il indique simplement un nombre d'articles ou de CI et c'est UFAS-EXTENDED qui assure la conversion en espace disque.

Pour déterminer le nombre de pistes requis, la meilleure méthode consiste à faireeffectuer le calcul par le processeur CREATE_FILE en simulant la création du fichier (voirplus loin dans ce chapitre).


47 F2 04UF Rev04 6-37

L'utilisateur dispose de la commande REPORT pour lister les caractéristiques retenues.Consulter le manuel de référence de l'utilisateur IOF pour plus de détails à ce sujet.

On peut convertir le nombre de pistes en nombre de cylindres, comme suit :

Nombre de cylindres =

(Nb total de pistes) divisé par (Nb de pistes par cyl.)


Exemple :

Soit le fichier JC.EXP, à implanter dans le volume TNDA sur MS/D500, avecUNIT = TRACK.


Nombre de pistes = 95



Clé primaire :

Position début = 5 (paramètre KEYLOC)

Longueur = 20 (paramètre KEYSIZE)

Clés secondaires (à définir dans le paramètre SECIDX) :

Clé 1 :


Longueur = 10

Clé 2 :


Longueur = 50

Clé 3 :




6-38 47 F2 04UF Rev04

Clé 4 :



Le tableau 6-1. indique qu'avec CISIZE = 6656, il y a 5 CI de données par piste surMS/B10.

La commande BUILD_FILE se présente donc comme suit :

BF JC.EXP:TNDA:MS/B10 EXPDATE = 199 FILESTAT = CAT UFAS = INDEXED UNIT = TRACK (UNIT = RECORD ou UNIT = CYL SIZE =95 SIZE = 7360* SIZE = 2 ) CISIZE = 6656 RECSIZE = 200 RECFORM = F KEYLOC = 5 KEYSIZE = 20 SECIDX = (30:10 45:50 96:40:DUPREC 138:30:DUPREC);

Le nombre d'articles du fichier s'obtient par la commande CREATE_FILE (équivalent JCL= FILALLOC), et la place allouée à chaque espace adresses par la commandeLIST_FILE. Le nombre d'articles se calcule en multipliant le nombre de CI de l'espaceadresses 2 par le nombre d'articles par CI.

* A noter que SIZE = 7360 a été obtenu au moyen de la commande CREATE_FILE.


47 F2 04UF Rev04 6-39

6.8 GCL DE CREATION, DE LISTAGE ET DE MODIFICATION

L'utilisateur trouvera ici la syntaxe des commandes et groupes de paramètres GCLpermettant de créer et de modifier des fichiers disque, avec dans chaque cas quelquesexemples. Ces éléments du langage GCL sont décrits en détail dans le manuel deréférence de l'utilisateur IOF.

Des tables de correspondance GCL/JCL et JCL/GCL figurent à l'annexe D. Les ordresJCL sont décrits dans le manuel de référence JCL et dans le manuel traitant des utilitairesde gestion des données.

6.8.1 Commande BUILD_FILE

La commande BUILD_FILE permet de créer un fichier disque. La création comprendl'affectation de place et l'écriture des labels contenant les attributs du fichier.

L'équivalent JCL de BUILD_FILE est l'ordre PREALLOC.

Remarques importantes sur les fichiers FBO :

Pour les fichiers implantés sur disques FSA, il est recommandé de spécifier UNIT =BLOCK ou UNIT = 100KB.

Néanmoins, pour des raisons de compatibilité, il est toujours possible d'utiliser les"anciennes" unités de réservation (UNIT = CI, RECORD, CYL ou TRACK).

A l'exécution, UFAS-EXTENDED convertit automatiquement les CI en blocs (si UNIT =CI), les cylindres en quanta de 1000 Ko (si UNIT = CYL) et les pistes en quanta de 50 Ko(si UNIT = TRACK).

Il est donc plus simple de spécifier UNIT = BLOCK ou UNIT = 100KB pour les fichiersimplantés sur disques FBO.


6-40 47 F2 04UF Rev04

Syntaxe de la commande BUILD_FILE :

{ BUILD_FILE }{ }{ BF }

FILE = file78

{ CAT } { CAT{1|2|3|4|5} } [ FILESTAT = { } ] { UNCAT } { TEMPRY }

{ jjj } [ EXPDATE = { aa/jjj } ] { aa/mm/jj }

[ UFAS = SEQ ]

- - - - - - - - - - - - - - - - - - - -

[ UNIT = { CYL | BLOCK | 100KB | RECORD | TRACK | CI } ]

[ SIZE = déc10 ]

[ SPLIT = (critères-de-fractionnement) ]

[ SPLITDVC = classe-appareils-fractionnement ]

[ INCRSIZE = déc5 ]

[ MAXEXT = { 5 | déc2 } ]

[ CISIZE = déc5 ]

[ RECSIZE = déc5 ]

[ KEYLOC = déc5 ]

[ KEYSIZE = déc3 ]

[ CIFSP = { 0 | déc3 } ]

[ COLLATE = { EBCDIC | ASCII | BCD } ]

[ SECIDX = (jjjj:jj[:DUPREC]...)]

[ DDLIB1 = lib78 ]

[ AREA = nom30 ]

[ INDEX = nom30 ]

[ SCHEMA = nom30 ]

[ RECFORM = { F | FB | V | VB | U } ]

[ SILENT = { bool | 0 } ]


47 F2 04UF Rev04 6-41

6.8.1.1 Exemples de création par la commande BUILD_FILE

Dans tous les exemples qui suivent, les fichiers ont le format UFAS-EXTENDED. A noterque la meilleure méthode consiste à utiliser la commande CREATE_FILE pour simuler lacréation d'un fichier (voir précédemment).

Exemples avec des fichiers séquentiels :

BF PK.ALI:PAN:MS:FSA FILESTAT = CAT UFAS = SEQ UNIT = BLOCK SIZE = 287 CISIZE = 3584 RECSIZE = 228 RECFORM = V;

Création du fichier catalogué PK.ALI dans levolume PAN sur MS/FSA. Sa taille est de287 blocs. La taille de CI est de 3584 octets.Les articles ont une longueur de 228 octets ;leur format d'origine est variable.

BF PK.CT:VOL 11:MS/FSA FILESTAT = CAT UFAS = SEQ UNIT = 100KB SIZE =5 CISIZE = 4096 RECSIZE = 154;

Création du fichier catalogué PK.CT enunités de 100 Ko. L'espace total requis estde 500 Ko. Implicitement, les articles sont delongueur fixe (154 octets).

BF LP.PJM$RES FILESTAT = UNCAT UFAS = SEQ UNIT = CI SIZE = 600 CISIZE = 1000 RECSIZE = 190;

Création du fichier résidant de 600 CI dedonnées. La taille de CI (1000) n'étant pasun multiple de 512, UFAS-EXTENDEDl'arrondit automatiquement au multipleimmédiatement supérieur, c'est-à-dire 1024.Implicitement, les articles sont de longueurfixe (190 octets). Chaque CI de donnéescontient cinq articles. La capacité totale dufichier est donc 5 x 600 = 3000 articles.

BF FILE = F2:V9:MS/D500 FILESTAT = UNCAT UFAS = SEQ SIZE = 1 CISIZE = 2048 RECSIZE = 100;

Création du fichier non catalogué F2 dans levolume V9. L'unité d'affectation estimplicitement le cylindre. La taille du fichierest de 1 cylindre. La taille de CI est de 2048octets. La longueur d'article est de 100octets.

BF POW.LM$RES UFAS = SEQ SIZE = 5000 UNIT = RECORD INCRSIZE = 1000 CISIZE = 2048 RECSIZE = 60;

Création du fichier séquentiel POW.LM dansun ou plusieurs volumes résidants. Sa tailleest de 5000 articles, et son incrément de1000 articles. La taille de CI est de 2048octets, la longueur d'article de 60 octets.

BF JKL.MY UFAS = SEQ SPLIT = (V8:4 V9:6 V6:7)

SPLITDVC = MS/D500

INCRSIZE = 2 CISIZE = 1024 RECSIZE = 200 RECFORM = F;

Création du fichier JKL.MY avec 4 cylindresdans le volume V8, 6 cylindres dans levolume V9 et 7 cylindres dans le volume V6.JKL.MY est implicitement catalogué. Lesvolumes sont sur MS/D500. La taille del'incrément est de 2 cylindres maximum parvolume. La taille de CI est de 1024 octets.Les articles sont de longueur fixe (200octets).


6-42 47 F2 04UF Rev04

Exemples avec des fichiers relatifs FBO :

BF PK.LOY:V44:MS/FSA EXPDATE = 340 UNIT = BLOCK SIZE = 30 UFAS = RELATIVE CISIZE = 19456 RECSIZE = 88 FILESTAT = CAT;

Création du fichier PK.LOY dans le volumeV44 sur MS/FSA. La taille de CI est de19456 octets, la taille d'article de 88 octets.D'après une simulation effectuée au moyende CREATE_FILE, ce fichier doit avoir unetaille de 30 blocs pour pouvoir contenir 6119articles.

Exemple avec des fichiers relatifs VBO

BF MPTSP.DD EXPDATE = 300 UNIT = CYL SPLIT = (D18A:10 D18B:10) SPLITDVC = MS/D500 UFAS = RELATIVE CISIZE = 1024 RECSIZE = 52 FILESTAT = CAT;

Le fichier relatif MPTSP.DD est implanté surdeux volumes, D18A et D18B; de 10cylindres chacun. Il peut être réparti sur lesdeux disques, de façon à réduire ledéplacement de la tête de lecture en accèsdirect. La période de rétention du fichier estde 300 jours.

Exemples avec des fichiers séquentiels indexés :

BF LM.TOR1:LU5:MS/FSA FILESTAT = CAT UFAS = INDEXED UNIT = BLOCK SIZE = 198 CISIZE = 4096 RECSIZE = 211 RECFORM = F KEYLOC = 1 KEYSIZE = 16 CIFSP = 12;

Création du fichier LM.TOR1 dans le volumeLU5 sur MS/FSA. L'unité d'affectation est lebloc. D'après une simulation au moyen deCREATE_FILE, la taille nécessaire est de198 blocs. La taille de CI est de 4096 octets.Les articles, de longueur fixe, font 211octets. La clé primaire, de 16 octets,commence à la position 1. Il n'y a pas declés secondaires. Un CI contient 18 articles,avec 12% d'espace libre par CI, ce quipermet l'insertion ultérieure de 2 articles parCI.

BF PC.UIX:TNDA:MS/D500 FILESTAT = CAT UFAS = INDEXED UNIT = CI SIZE = 26352 CISIZE = 3072 RECSIZE = 211 KEYLOC = 10 KEYSIZE = 21 CIFSP = 22;

Création du fichier PC.UIX dans le volumeTNDA sur MS/D500. Sa taille est de 26352CI de données. UFAS-EXTENDED ajouteraautomatiquement la place nécessaire pourl'espace adresses 1. Les articles ont unelongueur fixe de 211 octets. La clé primaire,de 21 octets, commence à la position 10. Iln'y a pas de clés secondaires. La taille de CIest de 3072 octets. L'espace libre demandépar CI est de 22 %.


47 F2 04UF Rev04 6-43

Dans cet exemple, il faut spécifier 22 % d'espace libre (paramètre CIFSP) pour permettrel'insertion ultérieure de 3 articles. En effet :


Par conséquent, le pourcentage d'espace nécessaire est de :

100 divisé par 14 = 7,15 %

pour 1 article, et donc de 22 % pour 3 articles.

L'exemple suivant illustre la création d'un fichier DEPT1.MY dans un catalogueautomatiquement utilisable au moment du traitement (attribut AUTOATT). Pour plus dedétails sur ce point, voir le guide de gestion des catalogues (15UF) et le volume 1 dumanuel de référence de l'utilisateur IOF (21UJ).

CREATE_DIR NAME = DEPT1;

Création (par l'administrateur du système)du répertoire maître DEPT1 sur la racine ducatalogue du site.

CREATE_CATALOG NAME = DEPT1.CATALOG VOLUME = K141:MS/D500 NBOBJECT = 10;

Création d'un catalogue automatiquementutilisable (valeur implicite). Une fois cecatalogue créé, le système sait que tous lesobjets catalogués dont le nom commencepar DEPT1 doivent être créés dansDEPT1.CATALOG ou extraits de ce dernier.

BF FILE = DEPT1.MY UFAS = INDEXED SPLIT= (BD14:10 BD15:10) SPLITDVC = MS/D500 CISIZE = 512 RECSIZE = 115 KEYLOC = 25 KEYSIZE = 30;

Création du fichier catalogué DEPT1.MYavec 10 cylindres dans chacun des volumesBD14 et BD15 sur MS/D500. La taille de CIest de 512 octets, la longueur d'article de115 octets. La clé primaire, de 30 octets,commence à l'octet 25.

BF F1:V7:MS/D500 FILESTAT = UNCAT UFAS = INDEXED SIZE = 4 CISIZE = 4096 KEYLOC = 25 KEYSIZE = 30 RECSIZE = 120;

Création du fichier non catalogué F1 dans levolume V7 sur MS/D500. Sa taille est de 4cylindres. La taille de CI est de 4096 octets.La clé primaire de 30 octets commence àl'octet 25. La longueur d'article est de 120octets. Il n'y a pas de clés secondaires.

BF PHK.JK UFAS = INDEXED SPLIT = (V1:2 V2:3 V3:5) SPLITDVC = MS/D500 INCRSIZE = 2 CISIZE = 1024 RECSIZE = 100 RECFORM = V KEYLOC = 12 KEYSIZE = 8 SECIDX = (8:4 30:8:DUPREC);

Création du fichier PHK.JK avec 2 cylindresdans le volume V1, 3 cylindres dans levolume V2 et 5 cylindres dans le volume V3.Ces volumes sont sur MS/D500. La taille del'incrément est de 2 cylindres. La taille de CIest de 1024 octets. Les articles sont deformat variable, et leur longueur maximumest de 100 octets. La clé primaire de 8 octetscommence à l'octet 12. Il y a deux cléssecondaires : la première, de 4 octets,commence à l'octet 8 et la deuxième, de 8octets, commence à l'octet 30. Il peut y avoirdes doubles pour la deuxième mais pas pourla première.


6-44 47 F2 04UF Rev04

6.8.2 Commande CREATE_FILE

La commande CREATE_FILE permet de créer un fichier disque en utilisantéventuellement comme modèle un fichier existant.

CREATE_FILE peut aussi s'utiliser pour simuler une création, en vue de déterminerl'espace à réserver dans BUILD_FILE (voir précédemment).

Pour les fichiers FBO, il est préférable de spécifier UNIT = BLOCK ou UNIT = 100KB.

L'équivalent JCL de CREATE_FILE est l'ordre FILALLOC.

Syntaxe de la commande CREATE_FILE :

{ CREATE_FILE }{ }{ CRF }

{ FILE } { } = fichier78 { OUTFILE }

{ LIKE } [ { } = ( description-fichier-entrée ) ] { INFILE }

[ IMMED = { bool | 0 } ]

{ CAT } { CAT{1|2|3|4|5} } [ FILESTAT = { } ] { UNCAT } { TEMPRY }


[ MORE = { bool | 0 } ]

- - - - - - - - - - - - - - - - - - - -

[ UNIT = { CYL | BLOCK | 100KB | TRACK } ]

[ SIZE = déc8 ]



[ PRTFILE = fichier78 ]

[ COMFILE = fichier78 ]

[ COMMAND = car255 ]

[ REPEAT = bool ]


47 F2 04UF Rev04 6-45

Exemple Commentaire

CRF A.MYF:DK1:MS/FSA LIKE = B.MYF IMMED;

Création du fichier A.MYF dans le volumeDK1 sur MS/FSA, à partir du fichier modèleB.MYF. La création est immédiate (sansdialogue). A.MYF est implicitementcatalogué (FILESTAT = CAT).

CRF F2:V1:MS/D500 LIKE = F1:V3:MS/D500 IMMED = 1 FILESTAT = UNCAT;

Création du fichier non catalogué F2 dans levolume V1 sur MS/D500, à partir du fichiermodèle F1.La création est immédiate ; l'utilisateur nepeut donc pas modifier les caractéristiquesdu fichier.

CRF FILE = F9:V9:MS/M500 FILESTAT = UNCAT;

Création du fichier non catalogué F9. Aucunfichier modèle n'est spécifié ; ce sont doncles caractéristiques implicites qui sontretenues, à savoir :organisation séquentielle, taille de CI = 3584octets, articles de format fixe, incrément de1 cylindre, unité de réservation = cylindre(CYL), longueur d'article = 200 octets.L'utilisateur a la possibilité de modifier cesvaleurs (implicitement IMMED=0), car ilentre dans le domaine CREATE_FILE.

CRF FILE = P2.F6:V8:MS/D500 LIKE = P2.F5 FILESTAT = CAT IMMED = 1;

Création du fichier catalogué P2.F6 dans levolume V8 sur MS/D500, à partir du fichiermodèle catalogué P2.F5. La création estimmédiate.

CRF FILE = P2.F6:V8:MS/D500 LIKE = P2.F5 FILESTAT = CAT;

Comme dans l'exemple précédent, mais lacréation n'est pas immédiate. L'utilisateurentre dans le domaine CREATE_FILE, etpeut modifier les caractéristiques du fichier.

CRF FILE = MINE6:VV:MS/D500 LIKE = P2.F5 FILESTAT = UNCAT;

Comme dans l'exemple précédent, mais lefichier MINE6 est à créer dans le volume VVet ne sera pas catalogué.

CRF FILE = XYZ$RES COMFILE = X.CRMF FILESTAT = UNCAT;

Création d'un fichier non catalogué sansmodèle, avec les paramètres extraits dufichier X.CRMF.


6-46 47 F2 04UF Rev04

Dans l'exemple précédent, les commandes à exécuter par le processeur CREATE_FILEpeuvent être fournies dans un fichier désigné par le paramètre COMFILE ou directementdans le paramètre COMMAND. Ces commandes sont les suivantes :

• CATALOG (CAT) : pour définir ou modifier les attributs catalogue du fichier.• CHANGE (CH) : pour définir ou modifier les caractéristiques du fichier.• CREATE (CR) : pour créer le fichier après modification de ses caractéristiques.• DELSIDX (DSX) : pour supprimer une ou toutes les clés secondaires du fichier.• FILTYPE (FT) : pour définir ou modifier l'organisation et le format du fichier.• LISTIDX (LSX) : pour lister une ou toutes les clés secondaires du fichier.• NUMSIDX (NSX) : pour renuméroter les clés secondaires du fichier.• QUIT (Q) : pour sortir du processeur CREATE_FILE.• REPORT (RP) : pour visualiser les caractéristiques retenues pour le fichier à créer.• SECIDX (SX) : pour définir ou modifier une clé secondaire du fichier.

Ou vous pouvez entrer ces commandes directement au terminal comme dans l'exempleci-dessous :

CRF .MYFILE$RES LIKE = P1.YOUFILE EXPDATE = 365;

(création d'un fichier catalogué avecdialogue, valide pendant un an).

Ces commandes sont décrites dans le manuel de référence de l'utilisateur IOF.


47 F2 04UF Rev04 6-47

6.8.3 Groupe de paramètres ALCn

Le groupe de paramètres ALCn permet de réserver de la place pour un fichier disque àcréer dynamiquement lors de l'exécution d'un programme utilisateur ou d'un utilitaire.

Le groupe ALCn est associé au paramètre FILEn et au groupe ASGn du fichier considéré.

Dans ALCn, les paramètres SIZE et INCRSIZE ne sont à utiliser que si les valeursimplicites ou existantes correspondantes ne conviennent pas. Le groupe ALCn n'est pasapplicable aux fichiers IDS/II.

Syntaxe :

EXEC_PR MYPROG

FILEi = nom-fichier-interne ASGi = nom-fichier-externe ALCi = ( [ SIZE = déc10 ](


[ UNIT = { CYL | BLOCK | 100KB | RECORD } ]

[ CHECK = { bool | 0 } ])

Pour les fichiers implantés sur disques FSA, il est recommandé de spécifier UNIT =BLOCK ou UNIT = 100KB.

Le groupe ALCn est décrit dans les volumes 1 et 2 du manuel de référence de l'utilisateurIOF (21UJ et 22UJ/23UJ).

Le groupe ASGn fournit les informations suivantes (voir chapitre 5) :

• nature du fichier : temporaire ($TEMPRY) ou permanent ;• nature du volume à utiliser : résidant ($RES) ou non ;• date de péremption du fichier (EXPDATE).

Le programme utilisateur fournit les informations suivantes :

• fichier UFAS (en COBOL, ORGANIZATION IS UFF, UFF étant la valeur implicite) ;• longueur d'article ;• format fixe ou variable des articles (en COBOL, FLR ou VLR) ;• pour un fichier séquentiel indexé, KEYSIZE et KEYLOC ; en COBOL, la clause

RECORD KEY IS désigne la clé primaire.Si les paramètres CISIZE et CIFSP sont omis dans le groupe DEFn (voir précédemment), leurs valeurs implicites sont les suivantes :

• CISIZE = 2048 octets• CIFSP = 0


6-48 47 F2 04UF Rev04

Les calculs d'espace sont les mêmes que ceux déjà décrits pour BUILD_FILE, mais UNIT= CI ou RECORD n'étant pas autorisé dans le groupe ALCn, les résultats doivent êtreexprimés :

en blocs,

en quanta de 100 Ko,

en cylindres,

en pistes.

L'équivalent JCL du groupe ALCn est l'ordre ALLOCATE.

Exemples Commentaire

EXEC_PG MONPG FILE1 = inf1 ASG1 = X$TEMPRY ALC1 = (SIZE=10);

Exécution du programme MONPG avecdemande de création dynamique du fichiertemporaire X associé au nom de fichierinterne inf1. L'unité d'affectation estimplicitement le cylindre.

EXEC_PG APROG FILE1 = OUTFILE ASG1 = A:VOL2:MS/D500 ALC1 = CHECK;

Exécution du programme APROG avecdemande de création dynamique du fichierA. Les paramètres de réservation de placesont implicites. Arrêt prématuré si le fichierexiste déjà.

EXEC_PG MONPROG FILE1 = DMFILE ASG1=(ZABC:B012:MS/D500 EXPDATE = 30) ALC1 = (SIZE = 10 INCRSIZE = 10);

Exécution du programme MONPROG avecdemande de création dynamique du fichierZABC. S'il existe déjà, il n'y aura pas d'arrêtprématuré. Sa période de validité est de 30jours. CATNOW n'étant pas spécifié, lefichier ZABC ne sera pas catalogué.

EXEC_PG PG = LM24 LIB = P2.F3 FILE1 = F1 ASG1 = WKF$TEMPRY ALC1 = (SIZE = 10);

Exécution du module chargeable LM24rangé dans la bibliothèque cataloguée P2.F3avec demande de création dynamique dufichier temporaire WKF. WKF aura une taillede 10 cylindres.


47 F2 04UF Rev04 6-49

6.8.4 Groupe de paramètres DEFn

Le groupe de paramètres DEFn (équivalent JCL = DEFINE)

• prévaut sur les paramètres fichier figurant dans le programme utilisateur, ou les complète,

• complète les attributs présents dans le label de fichier,

• fournit certains paramètres d'exécution (notamment pour la gestion des tampons et la journalisation).

Syntaxe du groupe de paramètres DEFn :

EXEC_PG MYPROG FILEn = nom-fichier-interne ASGn = nom-fichier-externe DEFn = ( [ FILEFORM = { UFAS } ]

[ FILEORG = { SEQ | RELATIVE | INDEXED } ]

[ BLKSIZE = déc5 ]

[ RECSIZE = déc5 ]

[ RECFORM = { F | V | U | FB | VB } ]

[ NBBUF = déc4 ]

[ SYSOUT = bool ]

[ DATAFORM = { SARF | SSF | DOF | ASA } ]

[ ERROPT = { SKIP | ABORT | IGNORE | RETCODE } ]

[ BUFPOOL = nom4 ]

[ CISIZE = déc5 ]

[ BPB = déc3 ]

[ CKPTLIM = { NO | EOV | déc8 } ]

[ FPARAM = bool ]

[ COMPACT = bool ]

[ TRUNCSSF = bool ]

[ CONVERT = bool ]

[ BSN = bool ]

[ paramètres-spécifiques-fichier-disque ]


6-50 47 F2 04UF Rev04

Les paramètres spécifiques du fichier disque sont :

[ JOURNAL = { BEFORE | AFTER | NONE | BOTH } ]

[ COLLATE = { BCD | ASCII | EBCDIC } ]

[ WRCHECK = bool ]

[ READLOCK = { NORMAL | EXCL | STAT } ]

[ LOCKMARK = bool ]

[ ADDRFORM = { LRRR | LRRRR | TTRDD | SFRA } ]

[ KEYLOC = déc5 ]

[ KEYSIZE = déc3 ]

[ CIFSP = déc3 ]

[ LTRKSIZE = déc3 ]

Pour plus de détails sur le groupe de paramètres DEFn, voir chapitre 5 de ce manuel et lemanuel de référence de l'utilisateur IOF.

L'équivalent JCL de ce groupe de paramètres est l'ordre DEFINE.


47 F2 04UF Rev04 6-51


EXEC_PG MONPROG POOLSIZE = 100 SIZE = 150 FILE1 = ifn1 ASG1 = CORJ1 DEF1= (NBBUF = 20 FILEORG = INDEXED BUFPOOL = B5)

Exécution du programme MONPROG avecaffectation du fichier CORJ1 associé au nomde fichier interne ifn1. CORJ1 est un fichierséquentiel indexé. 20 tampons lui sontalloués dans le pool de tampons B5.

FILE2 = ifn2 ASG2 = CORJ2 DEF2 = (NBBUF = 20 FILEORG = INDEXED BUFPOOL = B5)

Affectation du fichier CORJ2 associé aunom de fichier interne ifn2. CORJ2 est unfichier séquentiel indexé. 20 tampons luisont alloués dans le pool de tampons B5.









FILE7 = OUT ASG7 = OUTF ALC7 = (SIZE = 10 UNIT = CYL INCRSIZE = 2);

OUTF sera créé dynamiquement avec unetaille de 10 cylindres et un incrément de 2cylindres. OUTF ne fait pas partie du pool.


6-52 47 F2 04UF Rev04

6.8.5 Commande LIST_FILE

La commande LIST_FILE permet de lister, pour un fichier disque ou bande, desinformations telles que celles figurant dans son label, celles figurant au catalogue et cellesrelatives à son utilisation. Ces informations sont regroupées sous six rubriquesdifférentes, chacune pouvant être demandée ou non.

Syntaxe de la commande LIST_FILE :

{ LIST_FILE }{ }{ LSF }

{ FILE } { } = ( description-fichier-entrée) { INFILE }

[ CONTROL = { bool | 0 } ]

[ ORG = { bool | 0 } ]

[ SPACE = { bool | 0 } ]

[ USAGE = { bool | 0 } ]

[ SUBFILES = { bool | 0 } ]

[ SAVINFO = { bool | 0 } ]

[ ALL = { bool | 0 } ]

[ CATONLY { bool | 0 } ]



Pour une description complète des paramètres de la commande LIST_FILE, consulter lemanuel de référence de l'utilisateur IOF.

L'équivalent JCL de cette commande est l'ordre FILLIST.


47 F2 04UF Rev04 6-53

6.8.6 Commande LIST_FILE_SPACE

La commande LIST_FILE_SPACE permet de lister les informations relatives à l'espaceaffecté à un fichier.

Syntaxe de la commande LIST_FILE_SPACE :

{ LIST_FILE_SPACE }{ }{ LSFSP }

{ FILE } { } = fichier78 { INFILE }



Pour une description complète des paramètres de la commande LIST_FILE_SPACE,consulter le manuel de référence de l'utilisateur IOF.

L'équivalent JCL de cette commande est l'ordre FILLIST.


LSFSP A.MONFIC; Listage d'informations sur l'espace affecté aufichier catalogué A.MONFIC.

LSFSP F3:X:MS/D500; Listage d'informations sur l'espace affecté aufichier non catalogué F3.

LSFSP A.MONFIC PRTFILE = A.OUT;

Listage d'informations sur l'espace affecté aufichier catalogué A.MONFIC.Stockage du compte rendu dans le fichierA.OUT et affichage des messages d'erreur auterminal de l'utilisateur.

LSFSP A.MONFIC SILENT PRTFILE = A.OUT;

Listage d'informations sur l'espace affecté aufichier catalogué A.MONFIC.Les erreurs sont consignées dans le fichierA.OUT, mais ne s'affichent pas au terminal del'utilisateur.


6-54 47 F2 04UF Rev04

6.8.7 Commande MODIFY_FILE

La commande MODIFY_FILE permet de modifier les caractéristiques d'un fichier. Pourles fichiers implantés sur disques FSA, il est préférable de spécifier UNIT = BLOCK.

Syntaxe de la commande MODIFY_FILE :

{ MODIFY_FILE }{ }{ MDF }

FILE = fichier78

[ NEWNAME = fichier44 ]


[ UNIT = { BLOCK | CYL | TRACK } ]


{ NORMAL } { ONEWRITE } { MONITOR } [ SHARE = { } ] { DIR } { FREE } { UNSPEC }

{ NORMAL } { ONEWRITE } [ DUALSHR = { } ] { FREE } { NONE }

{ NO } { BEFORE } [ JOURNAL = { AFTER } ] { BOTH } { PRIVATE }

[ SLOCK = { IO | IN | AP | IA | OFF } ]

[ UNLOCK = bool ] [ SYMGEN = nom5 ] [ CLEARMD = bool ] [ FIRSTVOL = déc2 ] [ LASTVOL = déc2 ] [ VOLSET = nom6 ] [ CLRVSET = bool ] [ MOUNT = déc1 ] [ SILENT = { bool | 0 } ] [ FORCE = bool ] [ IOC = { DEFAULT | BYPASS | FORCE } ] [ LOGSUBF = bool ]

Pour une description complète des paramètres de la commande MODIFY_FILE,consulter le manuel de référence de l'utilisateur IOF.


47 F2 04UF Rev04 6-55

L'équivalent JCL de cette commande est l'ordre FILMODIF.


MDF A.BCNEWNAME = A.XCEXPDATE = 365;

Modification du nom et de la date de péremptiondu fichier A.BC.

MDF PROJ.F3SHARE = ONEWRITEDUALSHR = NORMAL;

Modification des conditions de partage du fichierPROJ.F3 à l'intérieur du système (SHARE) etavec un système couplé (DUALSHR).


6-56 47 F2 04UF Rev04

6.8.8 Commande MODIFY_FILE_SPACE

La commande MODIFY_FILE_SPACE permet d'étendre l'espace affecté à un fichier.Cette commande n'est pas utilisable pour les fichiers relatifs. Pour les fichiers implantéssur disques FSA, il est préférable de spécifier UNIT = BLOCK ou UNIT = 100KB.

L'extension de fichier est traitée au chapitre 5. Pour l'extension dynamique, voir leparagraphe 6.3.5.

Syntaxe de la commande MODIFY_FILE_SPACE :

{ MODIFY_FILE_SPACE }{ }{ MDFSP }

NAME = fichier44

{ CAT } [ FILESTAT = { CAT{1|2|3|4|5} } ] { UNCAT }

[ VOL = { volume24 | RESIDENT } ]

[ SPLITDVC = classe-appareils-fractionnement ]

- - - - - - - - - - - - - - - - - - - -

[ UNIT = { CYL | BLOCK | 100KB | TRACK | SECTOR } ]

[ SIZE = déc8 ]

[ SPLIT = ( critères-fractionnement ) ]

[ REPEAT = bool ]


[ MAXEXT = { 16 | déc2 } ]


47 F2 04UF Rev04 6-57

Pour une description complète des paramètres de la commande MODIFY_FILE_SPACE,consulter le manuel de référence de l'utilisateur IOF.

L'équivalent JCL de la commande MODIFY_FILE_SPACE est l'ordre FILMODIF.


MDFSP A.B.C. SIZE = 30; Extension de 30 blocs pour le fichier cataloguéA.B.C dans le volume contenant la fin de fichier(indiqué par le catalogue).

MDFSP F1 UNCAT 30VOL2:MS/FSA;

Extension de 30 blocs dans le volume VOL2 surMS/FSA pour le fichier non catalogué F1. VOL2doit contenir la fin de fichier.

MDFSP MF UNCAT SPLIT = (VOL2:15VOL3:10) SPLITDVC = MS/D500;

Extension de 15 cylindres dans le volume VOL2et de 10 cylindres dans le volume VOL3 pour lefichier non catalogué MF. VOL2 doit contenir lafin de fichier.

MDFSP P1.F4 FILESTAT = CAT SIZE = 300 VOL = V4:MS/FSA;

Extension de 300 blocs (UNIT = BLOCK) pour lefichier catalogué P1.F4. Si V4 contient la fin defichier, l'extension aura lieu dans V4. Sinon, lesystème demandera le montage du volumecontenant la fin de fichier (son nom, V9, estextrait du catalogue), pour permettre l'accès auxinformations concernant l'organisation du fichier.L'extension commencera dans V9 et necontinuera dans V4 que si V9 ne comporte pasassez d'espace disponible.

MDFSP NAME = MONFIC FILESTAT = UNCAT SPLIT = (V3:2 V6:4) SPLITDVC = MS/D500;

Extension de 6 cylindres (2 dans le volume V3 et4 dans le volume V6) pour le fichier noncatalogué MONFIC. V3 et V6 sont sur MS/D500.V3 doit contenir la fin de fichier (avantextension).

MDFSP NAME = MONFICHIER SIZE = 2 FILESTAT = UNCAT;

Extension de 2 cylindres pour le fichier noncatalogué MONFICHIER (qui se trouve dans unvolume résidant). Son extension aura lieu dansce volume, puis, si nécessaire, dans unplusieurs autres volumes résidants montés surdes appareils de la même classe.


6-58 47 F2 04UF Rev04

47 F2 04UF Rev04 7-1

7. Fichiers bande (classique ou en cartouche)- Format standard, types, labels et création


Les bandes en cartouche (CT) apparues en V5 présentent les mêmes caractéristiquesque les bandes magnétiques classiques (MT). Ce chapitre traite exclusivement du formatde bande standard GCOS 7/EBCDIC (format natif spécifié par le paramètreLABEL = NATIVE en JCL).

• Types de fichiers bande.

• Labels.

• Attributs de fichier.

- Longueur d'article (paramètre RECSIZE).- Longueur de bloc (paramètre BLKSIZE).- Format d'article (paramètre RECFORM).

• Choix de la longueur de bloc.

• Création des fichiers bande (classique ou en cartouche).

• Paramétrage des fichiers bande dans EXEC_PG.

• Longueur minimale de bloc.


7-2 47 F2 04UF Rev04

7.2 TYPES DE FICHIERS BANDE

Un fichier bande peut être permanent catalogué, permanent non catalogué ou temporaire.

Fichier bande

Permanent Temporaire

Catalogué Non catalogué

Figure 7-1. Types de fichiers bande

Un fichier bande peut être monovolume ou multivolume. L'utilisateur peut lui fixer unedate de péremption.

Les volumes bande peuvent être multifichiers. Ce sont soit des volumes privés (propres àl'utilisateur), soit des volumes de manoeuvre (voir chapitre 5).

Fichiers bande (classique ou en cartouche) - Format standard, types, labels et création

47 F2 04UF Rev04 7-3

7.3 LABELS

Les labels sont constitués de blocs d'informations et sont placés avant et après lesdonnées proprement dites. Les labels standard GCOS 7/EBCDIC contiennent desindications sur le volume et le fichier, telles que :

• le nom du volume ;

• le numéro d'ordre du volume (pour les fichiers multivolumes) ; c'est le numéro relatif duvolume dans l'ensemble des volumes contenant le fichier ;

• la technique et la densité d'enregistrement ;

• le nom de fichier externe ;

• la longueur de bloc ; (BLKSIZE =)

• la longueur d'article ; (RECSIZE =)

• le format d'article. (RECFORM =)

L'utilisateur peut extraire ces informations à l'aide de la commande LIST_FILE (équivalentJCL = FILLIST).

Les labels de volume et de fichier bande sont décrits à l'annexe B.


7-4 47 F2 04UF Rev04

7.4 LES ATTRIBUTS DE FICHIER

Les attributs (longueur d'article, longueur de bloc et format d'article), lorsqu'il ne figurentpas dans les labels du fichier, doivent être spécifiés dans le programme utilisateur oudans le groupe de paramètres DEFn (équivalent JCL = DEFINE).

7.4.1 Longueur d'article (paramètre RECSIZE)

La longueur d'article déclarée dans le programme COBOL prévaut sur celle pouvant êtrespécifiée dans le GCL (ou le JCL). Il est donc inutile d'employer RECSIZE dans le groupede paramètres DEFn.

Pour les fichiers à articles de format variable, la longueur d'article déclarée doit être cellede l'article le plus long.

7.4.2 Longueur de bloc (paramètre BLKSIZE)

La longueur de bloc déclarée dans le programme COBOL (lorsque la clause BLOCKCONTAINS est présente) peut être recouverte par celle spécifiée au moyen du paramètreBLKSIZE du groupe DEFn (voir paragraphe 6.8.4).

Remarque : Lorsque RECFORM = V ou VB, la valeur de BLKSIZE doit êtreégale ou supérieure à (RECSIZE + 4).

7.4.3 Format d'article (paramètre RECFORM)

Pour les fichiers bande, il existe cinq formats d'article :

• articles de longueur fixe non groupés en blocs (RECFORM = F),

• articles de longueur fixe groupés en blocs (RECFORM = FB),

• articles de longueur variable non groupés en blocs (RECFORM = V),

• articles de longueur variable groupés en blocs (RECFORM = VB),

• articles de format indéterminé (RECFORM = U).

Le format (fixe ou variable) spécifié par le paramètre RECFORM du groupe DEFn doitcorrespondre à celui défini, explicitement ou implicitement, dans le programme COBOL.RECFORM permet en outre d'indiquer si les articles doivent être groupés en blocs ounon.


47 F2 04UF Rev04 7-5

Dans le cas d'un programme FORTRAN, seuls les articles de longueur fixe (groupés ounon) sont admis.

Exemple :

Soit un programme devant écrire des articles de 90 octets dans un fichier bande. Cesarticles de longueur fixe sont groupés à raison de 10 par bloc.

EXEC_PG MONPROGRAMME FILE1 = TFIXT ASG1 = (CMQ.PC EXPDATE = 20) DEF1 = (BLKSIZE = 900, RECFORM = FB);

La valeur du paramètre RECSIZE est fournie par le programme.

7.4.3.1 Articles de longueur fixe

Avec RECFORM = F ou FB, les articles sont tous de la même longueur. S'ils sontgroupés en blocs (plus d'un article par bloc), tous les blocs du fichier contiendront lemême nombre d'articles et seront donc tous de la même longueur, sauf le dernier dufichier, qui sera plus court que les autres s'il n'y a pas assez d'articles pour le remplir.

A rtic le

B lo c

A rtic le

B lo c

A rtic le

B lo c

A rtic le

B lo c

A rtic le A rtic le

B lo c

A rtic le

A rtic le s d e lo n gu eu r fixe g ro up é s e n b locs (2 a rtic le s pa r b lo c )

A rtic le s de lon gu e ur f ixe n on g ro u p és en b lo cs

Figure 7-2. Exemples d'articles de formats F et FB

Remarque : Si RECFORM = F, BLKSIZE = RECSIZE ; si RECFORM = FB,BLKSIZE = n*RECSIZE.


7-6 47 F2 04UF Rev04

7.4.3.2 Articles de longueur variable

Avec RECFORM = V ou VB, les articles peuvent avoir des longueurs différentes, àconcurrence de la longueur maximale spécifiée par l'utilisateur. S'ils sont groupés enblocs, la longueur maximale de bloc est également fixée par l'utilisateur. Ce maximumdoit être suffisant pour permettre aux blocs de contenir au moins un article de longueurmaximale. Les blocs regroupant des articles de longueur variable sont également delongueur variable, ce qui permet d'occuper au mieux l'espace alloué au fichier.

A chaque article est ajouté un descripteur d'article (RDW - Record Descriptor Word) dequatre octets par GCOS 7. Ce descripteur, créé et géré par le système, contient lalongueur de l'article.

A chaque bloc est ajouté un descripteur de bloc (BDW - Block Descriptor Word) dequatre octets par GCOS 7. Ce descripteur, créé et géré par le système, contient lalongueur du bloc.

Les programmes utilisateur n'ont pas accès aux descripteurs d'articles et de blocs, etn'ont pas à prendre en compte leur longueur.

La figure 7-3 montre une série d'articles de longueur variable. Soit un programme, quiécrit les articles A, B, ... etc. La longueur maximale d'article est de 125 octets (article C).

5 0 o cte ts 30 o cte ts 12 5 oc te ts

45 octe ts 48 o cte ts

15 o cte ts

A rtic le A

A rtic le C

A rtic leB

A rtic leD

A rtic leE

A rtic leF

Figure 7-3. Exemple d'articles de format V

Les attributs du fichier sont donc les suivants :

• RECSIZE = 125• BLKSIZE = 129• RECFORM = V

RECSIZE = 125, car l'article le plus long du fichier a 125 octets.

BLKSIZE = 129 octets, car à la longueur maximale d'article (125 octets) s'ajoute lalongueur du descripteur d'article (4 octets).

RECFORM = V, car les articles du fichier sont de longueur variable et non groupés enblocs.

La figure 7-4 montre comment les articles sont écrits dans le fichier.


47 F2 04UF Rev04 7-7

B S N R D WB D W

4 4 5 0

B S N R D WB D W

B S N R D WB D W

B S N R D WB D W

B S N R D WB D W

B S N R D WB D W

4 4 4 5

4 4 4 8

4 4 3 0

58 octe ts

38 octe ts

13 3 octe ts

A rtic le B

A rtic le A

A rtic le C

A rtic le D

23 octe ts

53 oc te ts

A rtic le E

56 octe ts

A rtic le F

4 4 12 5

4 4 1 5

Figure 7-4. Enregistrement des articles de format V


7-8 47 F2 04UF Rev04

Les numéros de bloc (BSN - Block Serial Number) sont créés et gérés par GCOS 7 (voirparagraphe suivant).

Les six articles de la figure 7-3 sont écrits dans six blocs distincts contenant chacun undescripteur de bloc (BDW) et un descripteur d'article (RDW). La longueur du plus grandbloc (celui contenant l'article C) est de 133 octets, à savoir BLKSIZE + 4, puisqueBLKSIZE ne prend pas en compte le descripteur de bloc (BDW), de la même manièreque RECSIZE ne prend pas en compte le descripteur d'article (RDW).

S'il souhaite grouper en blocs ses articles de longueur variable, l'utilisateur doit choisir leformat VB.

Dans ce cas, les attributs du fichier sont les suivants :

• RECSIZE = 125• BLKSIZE = 129• RECFORM = VB

La figure 7-5. montre comment les articles sont écrits dans le fichier.

B S N R D WB D W

B S N B D W R D W

R D W

4 4 5 0 4 3 0

4 4 1 2 5

4 4 1 5 4 4 5 4 4 8

B S N B D W R D W R D W R D W

92 octe ts

A rt ic le BA rtic le A

133 octe ts

A rt ic le FA rtic le EA rtic le D

124 octe ts

A rt ic le C

Figure 7-5. Enregistrement des articles de format VB

Les six articles de la figure 7-3 sont répartis dans trois blocs. Ils sont groupés àconcurrence de la longueur maximale de bloc augmentée du descripteur de bloc (BDW),à savoir BLKSIZE + 4.

Les blocs ne contiennent pas le même nombre d'articles et sont eux-mêmes de longueurvariable.


47 F2 04UF Rev04 7-9

7.5 CHOIX DE LA LONGUEUR DE BLOC

Le choix de la longueur de bloc dépend des facteurs suivants :

• blocs de longueur fixe ou variable,

• espace mémoire disponible pour les tampons.

La valeur de BLKSIZE est fonction de RECFORM et de RECSIZE :

• Si RECFORM = F, BLKSIZE doit être égal à RECSIZE.

• Si RECFORM = FB, BLKSIZE doit être un multiple de RECSIZE.

• Si RECFORM = V, BLKSIZE doit être égal à RECSIZE + 4.

• Si RECFORM = VB, BLKSIZE doit être un multiple de (RECSIZE + 4).

• Si RECFORM = U, BLKSIZE doit être égal à la longueur maximale d'article.

Chaque bloc étant séparé du bloc suivant par un espace interbloc (arrêt/marche) pourabsorber les mouvements de la bande, la capacité de stockage est directementproportionnelle à la valeur de BLKSIZE.

La capacité exacte d'une bande ne peut être calculée que pour les fichiers d'articles delongueur fixe, groupés ou non. Dans le cas des fichiers à articles de longueur variable,groupés ou non, l'utilisateur ne peut calculer qu'une capacité approximative en prenantune longueur moyenne de bloc.

Pour le calcul, les éléments suivants doivent être pris en compte :

• densité d'enregistrement,• longueur de l'espace interbloc,• longueur de la bande.

Ces valeurs figurent dans les guides opérateur correspondant à chaque type de dérouleurde bande (voir Préface pour les références).

La formule générale pour le calcul de la capacité d'une bobine est la suivante :

Nb blocs= (Longueur bande - sections début et fin) (Nb octets par bloc/Densité) + Long. espace interbloc

Dans le calcul, l'utilisateur doit également prendre en compte les numéros de bloc (BSN),d'une longueur de 4 octets. GCOS 7 écrit implicitement un BSN pour chaque bloc etsuppose la présence de BSN dans les fichiers d'entrée. Si, en sortie, un fichier ne doit pasavoir de numéros de bloc, il faut donner la valeur 0 au paramètre BSN du groupe DEFn.


7-10 47 F2 04UF Rev04

7.6 CREATION DES FICHIERS BANDE (CLASSIQUE OU EN CARTOUCHE)

Avant de pouvoir accueillir des fichiers, les volumes bande doivent faire l'objet d'unepréparation.

Cette opération, qui se réduit à une simple écriture des labels, s'effectue au moyen d'unedes commandes GCL suivantes :

PREPARE_TAPE (PRPTP) PREPARE_VOLUME (PRPV) en interactif uniquement .

Ces deux commandes sont décrites dans le manuel de référence de l'utilisateur IOF .

L'équivalent JCL de ces deux commandes est l'ordre VOLPREP, décrit dans le manueltraitant des utilitaires de gestion de données.

La création d'un fichier bande catalogué s'effectue au moyen de la commande GCLCREATE_MT_FILE (CRMTF) ; son équivalent JCL est l'ordre PREALLOC.

La création d'un fichier bande non catalogué s'effectue au moyen des groupes deparamètres GCL ASGn et DEFn (voir plus loin) ; leurs équivalents JCL sontrespectivement les ordres ASSIGN et DEFINE.

L'ordre PREALLOC est décrit dans le manuel traitant des utilitaires de gestion dedonnées.

Les ordres ASSIGN et DEFINE sont décrits dans le manuel de référence JCL.


47 F2 04UF Rev04 7-11

Syntaxe de la commande CREATE_MT_FILE :

{ CREATE_TAPE_FILE }{ CREATE_MT_FILE }{ CREATE_CT_FILE }{ CRTPF }{ CRMTF }{ CRCTF }

FILE = fichier-78

[ BLKSIZE = déc-5 ]

[ RECSIZE = déc-5 ]

[ WORKMT = { bool | 0 } ]

[ RECFORM = { FB | F | VB | V | U } ]

[ COMPACT = { bool | 0 } ]


[ NBSN = { bool | 0 } ]

[ MOUNT = { 1 | déc-1 } ]

[ ANSI = { bool | 0 } ]

[ END = UNLOAD ]


- - - - - - - - - - - - - - - - - - - -

[ REPEAT = { bool |0 } ]

[ CATALOG = { 1 | 2 | 3 | 4 | 5 } ]

Pour une description complète des paramètres de la commande CREATE_MT_FILE,consulter le volume 2 du manuel de référence de l'utilisateur IOF.


7-12 47 F2 04UF Rev04

Pour plus de précisions sur les labels de volume et de fichier, se reporter à l'annexe B.


CRTPF F.TRA:V2:MT/T9 BLKSIZE = 4000 RECSIZE = 1000 ANSI;

Création d'un fichier bande de formatANSI.

CRMTF F.SRC:VN:VT/T9 BLKSIZE = 2000 RECSIZE = 2000 RECFORM = F COMPACT EXPDATE = 10/08/95;

Création d'un fichier bande UFAS-EXTENDED, avec date de péremption ettassement des caractères espace.

CRCTF X.WK WORKMT;

Création du fichier bande X.WK dans unvolume de manoeuvre.

CRMTF P1.FI7:BANDE1:MT/T9/D1600 BLKSIZE = 4096 RECSIZE = 128 EXPDATE = 100;

Création du fichier bande catalogué P1.FI7dans le volume BANDE1 (9 pistes,1600 bpi).La longueur de bloc est de 4096 octets, lalongueur d'article de 128 octets et le fichierreste valide 100 jours à partir de la date dujour. Implicitement, le format des articlesest FB (fixe groupé).


47 F2 04UF Rev04 7-13

7.7 PARAMETRAGE DES FICHIERS BANDE DANS EXEC_PG

Pour les fichiers bande standard (GCOS 7/EBCDIC), deux cas sont à considérer.

• S'il s'agit d'un fichier d'entrée :

- l'affectation au traitement doit s'effectuer au moyen du groupe de paramètresASGn (voir chapitre 5) ; l'équivalent JCL est l'ordre ASSIGN ;

- la longueur de bloc figurant dans le label prévaut sur celle spécifiée dans leprogramme utilisateur ;

- la longueur et le format d'article figurant dans le label sont comparés aux valeurscorrespondantes du programme utilisateur pour assurer la cohérence ;

- l'organisation du fichier doit être déclarée séquentielle dans le programmeutilisateur.

A noter qu'il n'est pas nécessaire de spécifier le format du fichier (UFF ou LEVEL-64)dans le programme COBOL puisque aucune distinction n'est faite pour les fichiersbande.

• S'il s'agit d'un fichier de sortie :

- le système ne dispose pas d'informations label sur les attributs du fichier ; ceux-cidoivent donc être définis dans le programme utilisateur et/ou dans le groupe deparamètres DEFn (voir ci-dessous la syntaxe de ce paramètre, appliqué autraitement des fichiers de sortie sur bande).


7-14 47 F2 04UF Rev04

Syntaxe :

( [ FILEFORM = { UFAS | ANSI | NSTD } ]

[ FILEORG = { SEQ | RELATIVE | INDEXED } ]

[ BLKSIZE = déc-5 ]

[ RECSIZE = déc-5 ]

[ RECFORM = { F | V | U | FB | VB | FS | FBS } ]

[ NBBUF = déc-4 ]

[ SYSOUT = bool ]

[ DATAFORM = { SARF | SSF | DOF | ASA } ]

[ ERROPT = { SKIP | ABORT | IGNORE | RETCODE } ]

[ BUFPOOL = nom-4 ]

[ CISIZE = déc-5 ]

[ BPB = déc-3 ]

[ CKPTLIM = { NO | EOV | déc-8 } ]

[ FPARAM = bool ]

[ COMPACT = bool ]

[ TRUNCSSF = bool ]

[ CONVERT = bool ]

[ BSN = bool ]

[ paramètres-fichiers-bande ])

où les paramètres propres aux fichiers bande sont :

[ FUNCMASK = hexa-8 ]

[ DATACODE = { BCD | ASCII | EBCDIC } ]

[ BLKOFF = déc-3 ]

Remarque : Seuls les paramètres utilisables avec les fichiers bande sontdonnés ci-dessus. Pour une description complète du groupe DEFn,se reporter au manuel de référence de l'utilisateur IOF. L'ordre JCLcorrespondant, DEFINE, est traité dans le manuel de référenceJCL.


47 F2 04UF Rev04 7-15

7.8 LONGUEUR MINIMALE DE BLOC

La longueur minimale de bloc est de 18 octets.

Le bloc inclut le numéro de bloc (BSN), s'il est présent, et les descripteurs de bloc (BDW)et d'article (RDW), si RECFORM = V.

Avec cette valeur minimale de bloc, la longueur maximale d'article varie comme suit :

• 18 octets pour un fichier à articles de longueur fixe sans numéros de bloc ;

• 14 octets pour un fichier à articles de longueur fixe avec numéros de bloc ;

• 10 octets pour un fichier à articles de longueur variable sans numéros de bloc ;

• 6 octets pour un fichier à articles de longueur variable avec numéros de bloc.

7.9 DONNÉES COMPRESSÉES SUR BANDE

Le mode d'accès séquentiel permet de comprimer des données sur bande par lasuppression des espaces répétitifs. Vous devez spécifier l'attribut COMPACT, dansl'ordre DEFINE, lors de la création du fichier bande.

Les restrictions suivantes s'appliquent au fichier compressé :

• la taille de bloc spécifiée par l'utilisateur doit être au moins égale à la longueur d'articlemaximale + 4 octets pour l'en-tête + 1 caractère de contrôle pour chaque bloc dedonnées de 128 caractères ;

• la longueur d'article avant et après la compression ne doit pas dépasser 32 Koctets - 1(auquel cas la compression échoue et renvoie le code retour TSEQL 24, RECSZERR) ;

• seul le format d'article de type longueur variable est valide.


7-16 47 F2 04UF Rev04

47 F2 04UF Rev04 8-1

8. Fichiers disque et bande - Manipulation etmaintenance


• Tri et fusion (SORT_FILE ET MERGE_FILE).

• Chargement (LOAD_FILE).

- Passage du format UFAS au format UFAS-EXTENDED.

• Manipulation des fichiers et des données :

- Passage du format VBO au format FBO.

- Le langage DSL.

• Utilitaires de gestion de fichiers.

• Utilitaires de gestion de volumes.


8-2 47 F2 04UF Rev04

8.2 TRI ET FUSION (SORT_FILE ET MERGE_FILE)

Le tri et la fusion des fichiers disque et bande UFAS-EXTENDED s'effectuentrespectivement au moyen des commandes SORT_FILE et MERGE_FILE (voir manuel deréférence de l'utilisateur IOF). Les équivalents JCL sont les ordres SORT et MERGE,décrits dans le guide utilisateur de tri et fusion.

Fichiers disque et bande - Manipulation et maintenance

47 F2 04UF Rev04 8-3

8.3 CHARGEMENT (LOAD_FILE)

La commande LOAD_FILE permet de charger ou de réorganiser un fichier disque oubande. Le fichier d'entrée et le fichier de sortie peuvent être indifféremment de formatUFAS-EXTENDED ou UFAS.

Syntaxe de la commande LOAD_FILE :

{ LOAD_FILE }{ }{ LDF }

{ FILE } { } = ( description-fichier-sortie ) { OUTFILE }

INFILE = ( description-fichier-entrée )

{ CAT } { CAT{1|2|3|4|5} } [ DYNALC = { } ] { UNCAT } { TEMPRY }

{ ALLOCATE } [ { } = ( param-affectation-place-fichier-sortie ) ] { OUTALC }

{ DEF } [ { } = ( param-définition-fichier-sortie ) ] { OUTDEF }

[ INDEF = ( param-définition-fichier-entrée ) ]

{ DSLFILE } [ { } = { fichier-78 | ::TN } ] { COMFILE }

[ START = déc-8 ]

[ INCR = déc-8 ]

[ HALT = déc-8 ]

[ APPEND = { bool | 0 } ]

[ ORDER = bool ]

[ PADCHAR = { car-1 | hexa-2 } ]

[ KEYLOC = déc-5 ]

[ TAPEND = { 1 | déc-3 } ]


8-4 47 F2 04UF Rev04


- - - - - - - - - - - - - - - - - - - - [ PRINT = { ALPHA | HEXA | BOTH } ]

[ PRTFILE = fichier-78 ]

[ TITLE = car-114 ]

[ REPEAT = bool ]

[ FMEDIA = { bool | 0 ]

[ IMPORT = bool ]

[ EXPORT = bool ]

Pour une description complète des paramètres de la commande LOAD_FILE, consulter lemanuel de référence de l'utilisateur IOF.

L'équivalent JCL de la commande LOAD_FILE est l'ordre CREATE.


LDF (MONFIC ACCESS = SPWRITE EXPDATE = 94/07/31 INFILE = FRAN DYNALC = CAT;

Chargement du fichier MONFIC aprèscréation et catalogage avec date depéremption et droit d'accès exclusif. Lefichier d'entrée est FRAN.

LDF FILE = P1.F1 INFILE = PERSO:V1:MS/D500;

Chargement du fichier catalogué P1.F1 àpartir du fichier non catalogué PERSO setrouvant dans le volume V1 sur MS/D500.

LDF FILE = P1.F1:V2:MS/D500 INFILE = PERSO:V1:MS/D500 DYNALC = CAT ALLOCATE = (SIZE = 5 UNIT = CYL);

Comme dans l'exemple précédent, maisP1.F1 doit être créé dynamiquement dansle volume V2 sur MS/D500. La taille deP1.F1 sera de 5 cylindres.

LDF FIC2:V3:MS/D500 INFILE = PERSO1:V7:MS/D500;

Chargement du fichier non catalogué FIC2se trouvant dans le volume V3 surMS/D500, à partir du fichier non cataloguéPERSO1 implanté dans le volume V7 surMS/D500.


47 F2 04UF Rev04 8-5

8.3.1 Passage du format UFAS au format UFAS-EXTENDED

La commande LOAD_FILE (équivalent JCL = CREATE) peut être utilisée pour convertirun fichier UFAS au format UFAS-EXTENDED.

Pour ce faire, procéder comme suit :

1) Créer un nouveau fichier UFAS-EXTENDED à l'aide de la commande BUILD_FILE.

2) Transférer le contenu du fichier UFAS dans le fichier UFAS-EXTENDED à l'aide dela commande LOAD_FILE.

En utilisant le paramètre DYNALC dans la commande LOAD_FILE, il est possible desupprimer l'étape 1.

3) Supprimer le fichier UFAS.

4) Modifier le nom du fichier UFAS-EXTENDED en le remplaçant par celui de l'ancienfichier UFAS. Pour ce faire, utiliser la commande MODIFY_FILE avec le paramètreNEWNAME (voir tableau 8-1).

Remarque : Si la conversion doit porter sur plusieurs fichiers, employer lacommande LOAD_FILESET avec la convention astérisque pourdésigner chacun des deux ensembles d'entrée et de sortie.

Les exemples suivants illustrent la conversion d'ensembles de fichiers UFAS enensembles de fichiers UFAS-EXTENDED au moyen de commandes LOAD_FILESET(LDFST). La convention astérisque permet de désigner ces ensembles, et le paramètreDYNALC demande à chaque fois la création dynamique des fichiers de l'ensemble desortie.


LDFST (DUP* ACCESS = SPWRITE EXPDATE = 365) INSET = ORG* DYNALC = CAT;

Chargement de l'ensemble de fichiersDUP* à partir de l'ensemble de fichiersORG*. Les fichiers de l'ensemble DUP*seront créés dynamiquement et cataloguésavec date de péremption et droit d'accèsexclusif.

LDFST P1.**:V1:MS/D500 INSET = P2.** DYNALC = CAT;

Chargement de l'ensemble de fichiersP1.** à partir de l'ensemble de fichiersP2.**. Les fichiers de l'ensemble P1.**seront créés dynamiquement dans levolume V1 et catalogués.

LDFST FILESET = **:V2:MS/D500 INSET = **:V3:MS/D500$UNCAT DYNALC = UNCAT;

Les données de tous les fichiers noncatalogués de V3 seront chargées dans lesfichiers correspondants de V2. L'affectationde place dans V2 sera dynamique. V3 necontient pas de fichiers multivolumes.


8-6 47 F2 04UF Rev04

8.3.2 Passage du format VBO au format FBO

Un outil de migration accessible à partir d'IOF permet à l'utilisateur de convertir sesfichiers du format VBO au format FBO. Cet outil est le processeurMAINTAIN_MIGRATION (MNMIG). Il ne peut s'utiliser qu'en mode interactif et est réservéau projet SYSADMIN. Il permet de générer le JCL nécessaire à la migration directe ouindirecte des fichiers vers un volume FBO cible.

Pour plus de détails, se reporter au guide de l'utilisateur relatif à la migration de fichiers.


47 F2 04UF Rev04 8-7

8.4 MANIPULATION DES DONNEES : LE LANGAGE DSL

Le langage DSL est utilisable dans le cadre des commandes SORT_FILE (SORT enJCL), MERGE_FILE (MERGE en JCL), COMPARE_FILE et COMPARE_FILESET(COMPARE en JCL), LOAD_FILE et LOAD_FILESET (CREATE en JCL), PRINT_FILE etPRINT_FILESET (PRINT en JCL). Il permet les opérations suivantes :

• sélection/omission de certains articles du fichier d'entrée ;

• réorganisation des zones de données à l'intérieur de chaque article de sortie ;

• modification de la longueur des articles en sortie ;

• spécification des zones-clés, pour SORT_FILE/MERGE_FILE ;

• cumul de zones spécifiées, dans les articles ayant la même valeur de clé, pourSORT_FILE/MERGE_FILE.

Pour plus de précisions sur le langage DSL dans le cadre de SORT_FILE, consulter leguide utilisateur de tri et fusion (08UF).

Pour plus de précisions sur le langage DSL dans le cadre de COMPARE_FILE,LOAD_FILE et PRINT_FILE, consulter le manuel traitant des utilitaires de gestion dedonnées.


8-8 47 F2 04UF Rev04

8.5 UTILITAIRES DE GESTION DE FICHIERS

Le tableau suivant donne la liste des utilitaires de gestion des fichiers disque et bandeUFAS-EXTENDED.

Tableau 8-1. Utilitaires de niveau de fichier (1/3)

Commande GCL Fonction

BUILD_FILE (BF) Crée un fichier disque.

CLEAR_FILE (CLRF) Efface un fichier (supprime logiquement son contenu) sanslibérer la place qu'il occupe.

COMPARE_FILE (CMPF) Compare logiquement le contenu de deux fichiers triés.

COMPARE_FILESET(CMPFST)

Compare logiquement le contenu de chaque fichier triéd'un ensemble au contenu d'un fichier de référence trié.

COPY_FILE (CPF) Copie le contenu d'un fichier dans un autre fichier de typeidentique.

COPY_FILESET (CPFST) Copie le contenu d'un ensemble de fichiers dans un autrefichier de type identique.

CREATE_CT_FILE(CRCTF)

Crée un fichier sur bande en cartouche.

CREATE_MT_FILE(CRMTF)

Crée un fichier catalogué sur bande classique.

CREATE_FILE (CRF) Crée un fichier disque, en utilisant éventuellement commemodèle un fichier existant. Peut servir à simuler uneréservation de place pour un fichier.

CREATE_FILESET(CRFST)

Crée un ensemble de fichiers disque, en utilisantéventuellement comme modèle un fichier ou un ensemblede fichiers existant.

DELETE_FILE (DLF) Supprime un fichier disque ou un fichier bande catalogué,en libérant la place qu'il occupe (suppression de sarubrique catalogue).

DELETE_FILESET(DLFST)

Supprime un ensemble de fichiers disque, ou de fichiersbande catalogués, en libérant la place qu'ils occupent etmet à jour le catalogue en conséquence.

EXPAND_FILESET(EXPFST)

Liste les noms des fichiers constituant le ou les ensemblesspécifiés.

LIST_FILE (LSF) Liste, pour un fichier disque ou bande, des informationstelles que celles enregistrées dans son label, celles figurantau catalogue et celles relatives à son utilisation.


47 F2 04UF Rev04 8-9



LIST_FILESET (LSFST) Liste des informations relatives aux fichiers d'un ensemblede fichiers.

LIST_FILE_SPACE(LSFSP)

Liste l'espace affecté à un fichier.

LOAD_FILE (LDF) Charge un fichier UFAS-EXTENDED. Copie une aireIDS/II.

LOAD_FILESET (LDFST) Charge un ensemble de fichiers UFAS-EXTENDED. Copieun ensemble de fichiers IDS/II.

MAINTAIN_FILE (MNF) Vide les enregistrements physiques d'un fichier disque oubande. Dans le cas d'un fichier disque, permet de modifierdes données et/ou des informations de gestion dans lesenregistrements physiques.

MERGE_FILE (MRGF) Lance l'utilitaire MERGE, qui permet de fusionner de deuxà huit fichiers triés, soit dans un nouveau fichier, soit dansun fichier existant.

MODIFY_FILE (MDF) Modifie les caractéristiques d'un fichier.

MODIFY_FILE_SPACE(MDFSP)

Etend l'espace affecté à un fichier.

MODIFY_FILE_STATUS(MDFSTAT)

Modifie le statut d'un fichier (catalogué ou non catalogué).

PRINT_FILE (PRF) Imprime les articles d'un fichier.

PRINT_FILESET (PRFST) Imprime les articles d'un ensemble de fichiers.

RESTORE_FILE (RSTF) Restaure le contenu d'un fichier disque à partir d'un fichierbande ou d'un fichier disque séquentiel UFAS-EXTENDEDdans lequel il avait été précédemment sauvegardé à l'aided'une commande SAVE_FILE ou SAVE_FILESET.Restaure également le contenu d'un fichier disquemonovolume à partir d'un fichier bande crééprécédemment au moyen d'une commande SAVE_DISK.

RESTORE_FILESET(RSTFST)

Restaure le contenu d'un ensemble de fichiers disque àpartir soit d'un fichier bande, soit d'un fichier disqueséquentiel UFAS-EXTENDED, soit d'un ensemble defichiers dans lequel il avait été précédemment sauvegardéà l'aide d'une commande SAVE_FILESET.Restaure également le contenu d'un ensemble de fichiersdisque monovolumes à partir d'un fichier bandeprécédemment créé au moyen d'une commandeSAVE_DISK.


8-10 47 F2 04UF Rev04



SAVE_FILE (SVF) Sauvegarde le contenu d'un fichier disque dans un fichierséquentiel UFAS_EXTENDED ou dans un fichier bande.

SAVE_FILESET (SVFST) Sauvegarde le contenu d'un ensemble de fichiers disquedans un fichier/ensemble de fichiers disque séquentielUFAS_EXTENDED ou dans un fichier/ensemble de fichiersbande.

SORT_FILE(SRTF/SORT)

Lance l'utilitaire SORT, qui permet de trier le contenu d'unou de plusieurs fichiers pour constituer un nouveau fichierou l'intégrer à un fichier existant.

SORT_INDEX (SRTIDX) Trie et charge les index secondaires d'un fichier séquentielindexé UFAS-EXTENDED.

Pour plus de précisions sur les commandes BUILD_FILE et CREATE_FILE, se reporterau chapitre 6 de ce manuel. Pour les autres commandes, consulter le volume 2 dumanuel de référence de l'utilisateur IOF (22UJ/23UJ).


47 F2 04UF Rev04 8-11

8.6 UTILITAIRES DE GESTION DE VOLUMES

Le tableau suivant donne la liste des utilitaires de gestion des volumes disque et bande.

Tableau 8-2. Utilitaires de niveau volume


CLEAR_VOLUME (CLRV) Efface le contenu d'un volume.

LIST_VOLUME (LSV) Liste des informations relatives à un volume disque oubande natif et aux fichiers qu'il contient.

MAINTAIN_VOLUME(MNV)

Vide les enregistrements physiques d'un volume disque oubande. Dans le cas d'un disque, permet de modifier desdonnées et/ou des informations de gestion dans lesenregistrements physiques.

MODIFY_DISK (MDD) Permet d'effectuer un contrôle de surface et une mise auformat sur un volume disque. Permet également dedéclarer des pistes défectueuses ou réutilisables.

PREPARE_DISK (PRPD) Effectue la préparation d'un volume disque : écriture deslabels, mise au format de pistes, contrôle de surface. Lesmêmes opérations peuvent être effectuées en modeinteractif à l'aide de la commande PREPARE_VOLUME.

PREPARE_TAPE(PRPTP)

Effectue la préparation d'un volume bande, consistant enune simple écriture des labels. Cette opération peut êtreeffectuée en mode interactif à l'aide de la commandePREPARE_VOLUME.

PREPARE_VOLUME(PRPV)

Effectue la préparation d'un volume disque ou bande. Lapréparation consiste en l'écriture des labels. Pour lesdisques, elle comporte également le formatage, le contrôlede surface et la déclaration des pistes défectueuses. Cettecommande n'est utilisable qu'en mode interactif. Pourpréparer un volume disque à partir d'un fichier decommandes, utiliser PREPARE_DISK. Pour préparer unvolume bande à partir d'un fichier de commandes, utiliserPREPARE_TAPE.

RESTORE_DISK (RSTD) Restaure un volume disque natif à partir d'un fichier bandenatif créé par une commande SAVE_DISK

SAVE_DISK (SVD) Sauvegarde un volume disque natif dans un fichier bandenatif.

Pour plus de précisions sur ces commandes, consulter le manuel de référence del'utilisateur IOF.


8-12 47 F2 04UF Rev04

8.7 VISIBILITÉ DE L'ESPACE PHYSIQUE ET LOGIQUE AFFECTÉ AUXFICHIERS DISQUE UFAS

Dans l'espace adresses 1 d'un fichier disque UFAS, sont précisés le nombre de CIaffectés et le nombre de CI (affectés) formatés.

Cette information apparaît dans la liste USAGE de LIST_FILE[SET] ou de LIST_VOLUME(équivalents JCL : FILLIST ou VOLIST), si l'option USAGE est spécifiée.

A la création d'un fichier disque UFAS, les fragments (extents) physiques (répertoriés parl'option SPACE) correspondent étroitement aux informations logiques (répertoriées parl'option USAGE).

Lorsqu'un fichier disque UFAS fait l'objet d'une extension via la commande GCLMODIFY_FILE_SPACE (ou PREALLOC avec l'option EXTEND), l'espace adresse 1 nepeut être immédiatement mis à niveau. Les données de type USAGE restent doncégalement inchangées (maximum, taux d'accès, nombre de CI affectés par espaceadresses). En revanche, les informations de type SPACE fournissent tous les fragmentsphysiques.

L'espace physique supplémentaire non encore décrit logiquement dans l'espaceadresses 1 fera l'objet d'une description dès que l'espace actuellement décrit logiquementdans l'espace adresses 1 deviendra insuffisant dans au moins un autre espace adresses,lors de l'ajout ou de la modification d'un article sous contrôle des méthodes d'accèsUFAS.

La restauration ou la copie d'un fichier d'entrée vers un fichier de sortie plus grand quenécessaire provoque le même résultat. L'espace adresses de sortie 1 étant une simplecopie de l'espace adresses d'entrée 1, il ne prend pas en compte l'espace de sortie entrop. En revanche, si la taille du fichier de sortie est inférieure à celle du fichier d'entrée,soit le fichier de sortie est étendu automatiquement ou, si c'est impossible, l'opération estabandonnée.

Cet impact peut se propager si des fichiers de ce type sont sauvegardés/restaurés oudupliqués vers d'autres fichiers, existants ou non.

47 F2 04UF Rev04 A-1

A. Fichiers relatifs - Randomisation

A.1 TECHNIQUES DE RANDOMISATION

Comme indiqué au chapitre 3, un fichier relatif est une suite de positions d'articleidentifiées chacune par une adresse relative appelée numéro relatif d'article (RRN). Lesnuméros relatifs d'articles peuvent s'obtenir en appliquant un algorithme de randomisationaux valeurs de clés. Après randomisation, les numéros relatifs d'articles sont convertis enadresses disque par le système.

Les différentes techniques de randomisation visent à obtenir une distribution égale desarticles dans l'espace disponible pour le fichier. Suivant la technique employée, le tauxd'occupation de l'espace disque peut atteindre 90 %. Toutefois, plus ce taux est élevé,plus le nombre de synonymes (clés générant la même adresse relative) risque d'êtreimportant, ce qui influera sur les temps d'accès. Le choix de la technique à adopter doitdonc assurer un équilibre correct entre le taux d'occupation et le nombre de synonymes.

Les techniques de randomisation décrites ici sont les suivantes :

• division par un nombre premier,

• élévation au carré, pliage et extraction,

• changement de base de numérotation,

• analyse des fréquences.

Pour choisir l'une ou l'autre de ces techniques, l'utilisateur doit prendre en compte lescritères suivants :

• taux d'occupation de l'espace disque,

• fréquence et distribution des synonymes,

• temps de traitement requis pour la randomisation,

• distribution uniforme des numéros relatifs d'article à l'intérieur du fichier.


A-2 47 F2 04UF Rev04

A.2 DIVISION PAR UN NOMBRE PREMIER

La division par un nombre premier constitue la méthode la plus largement utilisée pour laconversion des valeurs de clé en adresses relatives. Un nombre premier est un nombredivisible uniquement par 1 ou par lui-même. Le nombre à utiliser est le nombre premierimmédiatement inférieur au nombre total de positions d'articles possibles du fichier. Plusle nombre premier est grand, moins il y aura de synonymes.

Tableau A-1. Nombres premiers

5 13 23 37 47 61 73 89103113137151167181

197 223 233 251 269 281 307 317 347 359 379 397 419 433

449 463 487 503 523 557 571 593 607 619 643 659 677 701

727 733 761 787 811 827 853 863 883 911 937 953 977 997

1019 1033 1051 1069 1093 1109 1129 1163 1187 1213 1229 1249 1279 1291

1303 1321 1367 1399 1427 1439 1453 1481 1489 1511 1543 1559 1579 1601

1613 1627 1663 1693 1709 1733 1753 1783 1801 1831 1867 1877 1901 1931

1951 1987 1999 2017 2039 2069 2087 2111 2131 2143 2179 2213 2239 2267

2281 2297 2333 2347 2371 2383 2399 2423 2447 2473 2531 2549 2579 2609

2633 2659 2677 2689 2707 2719 2741 2767 2791 2803 2837 2857 2887 2909

295730013041308331373187322132593313334333733433

3467 3517 3541 3581 3617 3659 3697 3733 3779 3823 3863 3911

3931 4001 4021 4073 4111 4153 4211 4241 4271 4327 4363 4421

4457 4507 4547 4591 4639 4663 4721 4759 4799 4861 4909 4943

4973 5009 5051 5099 5147 5189 5233 5281 5333 5393 5419 5449

5501 5527 5573 5641 5659 5701 5743 5801 5839 5861 5897 5953

6029 6067 6101 6143 6199 6229 6271 6311 6343 6373 6427 6481

6551 6577 6637 6679 6709 6763 6803 6841 6883 6947 6971 7001

7043 7109 7159 7211 7243 7307 7349 7417 7477 7507 7541 7573

7603 7649 7691 7727 7789 7841 7879 7927 7963 7991 8009 8027

1. N om bres prem iers, de tro is en tro is, com pris entre 2 et 2939

2.Nom bres prem iers, de c inq en c inq, com pris en tre 2953 e t 8033

C'est le reste de la division, et non le quotient, qui fournit l'adresse.

Fichiers relatifs - Randomisation

47 F2 04UF Rev04 A-3

Exemple :

Soit un fichier de 800 articles dont la plage de clés va de 0 à 999 999 999. L'espaceréservé pour ce fichier correspond à 1 000 positions d'article. Le diviseur sera donc 997,nombre premier immédiatement inférieur à 1 000. Sur les 1 000 positions réservées, troisseulement seront inutilisées.

Si par exemple, la clé à traiter est 777 775 925, on aura :

777 775 925 divisé par 997 = 780 116 reste 273

L'article considéré sera enregistré à l'adresse relative 273.

Remarque : Lorsque les clés sont alphabétiques, ou alphanumériques, elles peuventêtre converties en nombre binaire qui sera divisé par le nombre binairecorrespondant au nombre premier à utiliser. La suite des calculs estégalement effectuée en binaire pour obtenir une adresse relativeexploitable.


A-4 47 F2 04UF Rev04

A.3 ELEVATION AU CARRE, PLIAGE ET EXTRACTION

Dans cette méthode de randomisation, la clé est élevée au carré, puis le résultat estpartagé en deux moitiés égales qui sont additionnées. Le nombre requis de chiffres pourl'adresse est ensuite extrait au milieu du résultat. Normalement, les deux caractères depoids faible (caractères de droite) sont ignorés, et l'extraction commence au troisièmecaractère de poids faible.

Exemple 1 :

Soit un fichier de 8 000 articles, dont la plage de clés va de 0 à 999 999 999. L'espaceréservé pour ce fichier correspond à 10 000 positions d'article.

La clé à traiter est 493 725 816.

628 631 037

Elévation au carré : 243 765 181 384 865 856

Pliage : 243 765 181 + 384 865 856

Extraction : 86 310 (adresse re lative de l'artic le)

Ce résultat est trop élevé pour un fichier de 10 000 articles. Il conviendrait dans le cas -peu probable - d'un fichier de 99 999 articles. Pour cet exemple, il aurait fallu extraireseulement quatre chiffres, ce qui donne une adresse maximum possible de 9 999. Cerésultat serait également inadapté pour un fichier de 7 000 articles.

Exemple 2 :

Soit un fichier de 4 000 articles, dont la plage de clés va de 0 à 999 999 999. L'espaceréservé pour ce fichier correspond à 6 000 positions d'article.

Si la clé à traiter est 493 725 816, comme dans l'exemple précédent, le résultat extrait(quatre chiffres) fournirait une adresse relative de 6 310.

Indépendamment du fait que cette adresse relative ne convient pas pour un fichier de6 000 positions d'article, on remarque que l'adresse maximum possible est encore del'ordre de 9 999.

Dans un tel cas, le résultat de l'extraction doit être réduit à l'aide d'un coefficient suffisantpour que la plus haute valeur possible soit adaptée à l'espace disponible dans le fichier.Ici, on obtient l'effet souhaité en multipliant le résultat de l'extraction par 0,6 :

6 310 * 0,6 = 3 786 (adresse relative de l'article)


47 F2 04UF Rev04 A-5

A.4 CHANGEMENT DE BASE DE NUMERATION

Cette technique s'applique à des clés exprimées dans une base autre que 10. La clé estconvertie chiffre par chiffre en base 10. La somme des valeurs ainsi obtenues comportele nombre de chiffres requis pour en extraire l'adresse relative d'article. L'extractioncommence par les caractères de droite. Le résultat extrait peut ensuite être adapté àl'espace disponible dans le fichier de même manière qu'au point précédent (multiplicationpar un coefficient).

Exemple :

Soit un fichier de 6 000 articles, dont la plage de clés va de 0 à 99 999. La place réservéeà ce fichier correspond à 7 500 positions d'article.

La clé à traiter est 14 623 en base 11.

Conversion en base 10 et somme des valeurs obtenues :

(1*11**4) + (4*11**3) + (6*11**2) + (2*11**1) + (3*11**0) =

(1*14 641) + (4*1 331) + 6*121) + (2*11) + (3*1) =

14 641 + 5 324 + 726 + 22 + 3 = 20 716

Extraction : 0716

Adaptation à l'espace disponible dans le fichier :

(0716*0,75) = (0)537 (adresse relative de l'article)


A-6 47 F2 04UF Rev04

A.5 ANALYSE DES FREQUENCES

• En premier lieu, l'analyse des fréquences fournit un schéma de distribution des chiffres0 à 9 dans les différentes positions de la clé pour l'ensemble du fichier. Cette techniquemet en évidence les meilleures positions pouvant servir de base au calcul d'adresse etpermet ainsi de choisir la méthode de randomisation la mieux adaptée.

• En second lieu, sous sa forme étendue, l'analyse des fréquences peut elle-mêmeconstituer une méthode de randomisation pour transformer les clés en adressesrelatives.

Aide au choix d'une méthode de randomisation

L'analyse des fréquences consiste à établir, pour chaque position de la clé, le nombred'occurrences des chiffres 0 à 9, sur l'ensemble du fichier.

Ainsi par exemple, dans un fichier de 16 045 articles :

• le chiffre 0 pourra figurer dans la 5ème position de la clé pour 5 168 articles,• le chiffre 1 pour 5 638 articles,• le chiffre 2 pour 4 958 articles,• le chiffre 3 pour 281 articles,• les chiffres 4 à 9 pour aucun article.

Si la distribution était régulière, chaque chiffre figurerait le même nombre de fois. Commeil y a 10 chiffres, pour un fichier de 16 045 articles, chaque chiffre devrait apparaîtreapproximativement 1 605 fois dans chaque position de la clé.

Pour déterminer l'écart par rapport à cette distribution homogène, il faut d'abord calculerpour chaque chiffre, la différence entre le nombre d'occurrences idéal et le nombred'occurrences réel dans chaque position de la clé.

Par exemple, si le chiffre 0 apparaît dans la 5ème position de la clé pour 5 168 articles,l'écart sera de :

5 168 - 1 605 = 3 563

• L'écart total pour chaque position s'obtient en cumulant les écarts calculés pour les dixchiffres (0 à 9).

• Cet écart total peut ensuite être exprimé en pourcentage du nombre total d'articles.Plus ce pourcentage est faible, plus la distribution est régulière.

Dans notre exemple, un écart total de 0 % ne serait obtenu pour une position de clé quesi elle présentait exactement 1 605 occurrences de chaque chiffre sur l'ensemble dufichier.


47 F2 04UF Rev04 A-7

Tableau A-2. Table des fréquences

Positions de c lé

Chiffres

0

1

2

3

4

5

6

7

8

9

Ecarttota l

Tota l arti-cles fich ier

Ecart to ta len %

1

16045

0

0

0

0

0

0

0

0

0

28885

16045

180

3

0

4408

3792

2231

2459

3155

0

0

0

0

16045

16045

100

4

1852

3147

1174

2724

1194

1267

1243

1228

1227

989

5821

16045

36

5

5168

5638

4958

281

0

0

0

0

0

0

21903

16045

137

6

1807

2120

1745

1684

1378

1647

1560

1329

1415

1360

1961

16045

12

7

1738

1748

1743

1610

1617

1688

1660

1450

1411

1434

1035

16045

6

Total

26610

17061

15610

9106

7843

19833

4409

4007

4053

3783

occurrences 2

0

0

2198

576

1195

12076

0

0

0

0

22133

16045

138

Une fois établie, la table des fréquences permet de déterminer les meilleures positions àutiliser pour servir de base au calcul d'adresse.

A noter que l'écart total obtenu pour la position 3 (100 % du nombre total d'articles) estl'effet du hasard.


A-8 47 F2 04UF Rev04

A.5.1 Transformation clé-adresse relative

Le processus de randomisation est le suivant :

• Calcul du nombre total d'occurrences de chaque chiffre dans l'ensemble des positionsde la clé (colonne de droite dans la figure A-2).Ex : Le chiffre 0 apparaît 26 610 fois dans l'ensemble de la clé.

• Conversion du nombre d'occurrences de chaque chiffre dans chaque position de la cléen pourcentage du nombre total d'articles du fichier (16 045 articles, dans l'exempleconsidéré).Ex : Le chiffre 0 apparaît 16 045 fois dans la position 1, donc le pourcentage est 100 %.

Tableau A-3. Développement d'une adresse relative

1

100 39915

17061

15610

9106

7843

19833

4409

4007

4053

3783

2

26610

17061

14 16703

4 9288

7 8118

75 27270

4409

4007

4053

3783

3

26610 27 19364

24 17483

14 9743

15 8431

20 21816

4409

4007

4053

3783

4

12 28207 20 18767

7 16156

17 9880

7 8118

8 20626

8 4585

8 4167

8 4215

6 3896

5

32 30868 35 20047

31 18030

2 9197

7843

19833

4409

4007

4053

3783

6

11 28074 13 18170

11 16469

10 9561

9 8196

10 20825

10 4629

8 4167

9 4235

8 3934

7

11 28074 11 17999

11 16469

10 9561

10 8235

11 20924

10 4629

9 4187

9 4235

9 3953

C hiffres

0

1

2

3

4

5

6

7

8

9

%Constante

%Constante

%Constante

%Constante

%Constante

%Constante

%Constante

%Constante

%Constante

%Constante

Positions de c lé

Tota loccurrences

26610

17061

15610

9106

7843

19833

4409

4007

4053

3783


47 F2 04UF Rev04 A-9

A partir de ces totaux et de ces pourcentages, calcul d'une constante pour chaque chiffredans chaque position de la clé, au moyen de la formule suivante :

Constante = ((Kn% / 2) * dT) + dT AvecdT = Nombre total d'occurrences du chiffre considéré pour l'ensemble des positions de la cléKn% = Pourcentage calculé pour le chiffre considéré.

Exemple de calcul de constante :

Pour le chiffre 1 dans la position 5, on aura :

Constante = (17 061 + (( 35% / 2) * 17 061 ) = 17 061 + 2985,7 = 20 046,7 = 20 047 arrondi à l'entier supérieur

Après avoir associé chaque chiffre à une constante (arrondie) pour chaque position de laclé (voir Figure A-3), procéder comme suit pour chaque clé de l'article :

• Effectuer le cumul des constantes associées aux chiffres constitutifs de la clé enfonction de leur rang : on obtient une constante globale pour la clé considérée,

• Pour chaque clé, noter la constante la plus élevée et la constante la moins élevée,

• Construire une table des clés comme dans l'exemple fourni ci-dessous :

Tableau A-4. Table des clés

0

5

5

0

0

0

0

0

4

4

9

3

9

9

39915

8118

8431

3896

9197

3934

3953

77444

39915

27270

21816

28207

30868

28074

28074

204224

C lé 1

C lé 2

C lé 3

C lé 4

C lé 5

C lé 6

C lé 7

C hiffre Constan te Chiffre C onstante

* Valeurs arrondies à l'entier le p lus p roche.

Va leur m axim um * Valeur m in im um *


A-10 47 F2 04UF Rev04

Cumuler les constantes les plus élevées (valeurs maximum), puis les constantes lesmoins élevées (valeurs minimum) en vue d'obtenir une plage de valeurs utilisables pour latransformation clé-adresse relative :

204 224 - 77 444 = 126 780

Dans l'exemple considéré, on aura donc 126 780 adresses possibles.

Pour un fichier relatif de 16 045 articles, il semble convenable de réserver 20 000positions d'article, d'où la nécessité d'ajuster à ce nombre la plage de valeurs obtenue.Pour définir le coefficient d'ajustement, procéder comme suit :

Nombre d'articles = 20 000 = 0,157Plage de valeurs 126 780

Appliquer ensuite ce coefficient à la plage de valeurs :

126 780 * 0,157 = 19 904 arrondi à l'entier inférieur

On aura ainsi seulement 96 positions inutilisées sur les 20 000 allouées.

En appliquant ce coefficient à la borne inférieure de la plage de valeurs, on obtient :

77 444 * 0,157 = 12 159 arrondi à l'entier supérieur

204 224 * 0.157 = 32 064 arrondi à l'entier supérieur

La valeur 12 159 pourra être utilisée comme constante standard à soustraire desconstantes globales de clé (ajustées) pour les transformer en adresses relatives. Les 96positions inutilisées pourront servir pour les adjonctions éventuelles d'articles présentantdes clés situées hors de la plage définie à partir de l'analyse des fréquences.

Exemple de transformation clé-adresse relative :

Clé d'article = 0451185Constantes (positions) = 39 915+8118+21 816+18 767+20 047+4235+20 924=133 822Constante globale (clé) = 133 822Constante globale ajustée = (133 822 * 0,157) = 21 011 arrondi à l'entier supérieurAdresse relative d'article = 21 011 - 12 159 = 8 852

L'avantage de cette méthode réside dans le fait que le placement des articles s'effectueen fonction de la fréquence moyenne des combinaisons des chiffres dans la clé, même sila distribution résultante risque d'être diffuse.

Par exemple, la combinaison la plus probable, 0511110, générera l'adresse relative14 675, tandis que la moins probable, 0339399, générera l'adresse relative 6.

L'inconvénient majeur est le risque d'un nombre élevé de synonymes (qui nuisent auxtemps d'accès dans le programme utilisateur). Mais ce risque est fonction descombinaisons de clés existant réellement dans le fichier.

Une autre technique de transformation clé-adresse relative consiste à tronquer laconstante globale de clé. Par exemple, pour la clé 0451185, la constante globalecorrespondante 133 822 sera réduite à 33 822, en éliminant le 1 à droite. Il suffit ensuited'appliquer le coefficient 0,2 au nombre maximum de possibilités 99 999 pour pouvoirgénérer des adresses relatives adaptées à un fichier de 20 000 articles.


47 F2 04UF Rev04 A-11

A.6 CLES NON NUMERIQUES

Lorsque les clés contiennent des caractères non numériques (alphabétiques ouspéciaux), d'autres moyens doivent être employés. Par exemple, une technique utilisableconsiste à transformer les clés en nombres binaires pour pouvoir leur appliquer descalculs binaires ; on réduit ainsi les risques de synonymes.

Une autre technique consiste à convertir chaque caractère de la clé en deux chiffres, aumoyen d'un algorithme. La clé résultante est ensuite soumise à des calculs en décimal,variables suivant la méthode de randomisation. Cette technique s'avère utile lorsque lescalculs en binaire sont impraticables, mais elle présente l'inconvénient de doubler lalongueur des clés.


A-12 47 F2 04UF Rev04

47 F2 04UF Rev04 B-1

B. Volumes bande - Formats et labelsstandard

B.1 GENERALITES

Les systèmes DPS 7 disposent d'une large gamme de dérouleurs offrant une grandevariété de densités d'enregistrement et de débits. Ces dérouleurs acceptent des bandes 7pistes ou 9 pistes, en mode d'enregistrement non retour à zéro (NRZI) ou modulation dephase (PE). Le choix de l'utilisateur peut s'établir sur le rapport coûts/performances, maiségalement sur la possibilité de traiter des bandes d'autres constructeurs.

Sous GCOS 7, il existe deux formats de bande standard pour la création et la lecture :

• GCOS 7/EBCDIC (bandes 7 ou 9 pistes, contrôle par clé d'imparité).

• GCOS 7/ASCII (bandes 9 pistes, contrôle par clé d'imparité).

Les caractéristiques du format GCOS 7/EBCDIC sont les suivantes :

• Présence de labels standard (décrits plus loin à la figure B-1), ou absence de labels($NONE ou en JCL, LABEL = NONE), auquel cas la première marque de bandeindique la fin des données.

• Blocs d'articles de formats standard (F, FB, V, VB, U).

Les bandes GCOS 7/ASCII doivent comporter des labels et ne peuvent contenir des blocsd'articles de type U (format indéterminé).

Les fichiers bande peuvent être catalogués ou non :

• Pour déclarer les fichiers catalogués au système et au catalogue, utiliser la commandeCREATE_MT_FILE (CRMTF) (voir chapitre 7).

• Pour les fichiers non catalogués, les informations nécessaires sont à fournir dans legroupe de paramètres DEFn (voir chapitre 7).


B-2 47 F2 04UF Rev04

B.1.1 Relation volume (bobine)/fichier

Un fichier peut s'étendre sur une ou plusieurs bobines. S'il est implanté sur une seulebobine, il est dit monovolume ; s'il est implanté sur plusieurs, il est dit multivolume (lapremière partie du fichier est dans le volume 1, la deuxième dans le volume 2, etc.).

Remarques : 1. Les bandes de format non standard et les bandes sans label nepeuvent contenir que des fichiers monovolumes.

2. L'utilisateur COBOL a la possibilité de forcer une fin de volume(option CLOSE REEL), et pour un fichier multivolume, de rendrevisible la fin de bobine (voir manuel de référence COBOL 85 - 05UL).

B.1.2 Organisation des fichiers

Les fichiers bande ont une organisation séquentielle, c'est-à-dire que les articles, triés ounon, sont toujours lus séquentiellement par le programme, et que tout accès direct estimpossible. A chaque nouvelle insertion ou suppression d'article, la totalité du volume(bobine) doit être copiée. Il est impossible de lire un article en mode mise à jour, puis dele réécrire au même endroit. La mise à jour implique la création d'une nouvelle version dufichier à partir de l'ancienne.

Volumes bande - Formats et labels standard

47 F2 04UF Rev04 B-3

B.1.3 Organisation des données

BLOCS

Les blocs peuvent se composer d'un ou plusieurs articles, suivant la longueur d'articlespécifiée, et sont de longueur fixe ou variable (voir chapitre 7).

Les longueurs de bloc maximum et minimum sont conditionnées par les caractéristiquesdu matériel et du logiciel, ainsi que par l'utilisation éventuelle de la bande pour l'échanged'informations avec d'autres systèmes.

CONTRAINTES MATERIELLES ET LOGICIELLES

Le matériel autorise une longueur minimum de bloc de 18 caractères. Le tampon le pluspetit doit avoir au moins cette taille.

Le matériel et le logiciel ne fixent pas de limite à la longueur maximum de bloc. Ce sont lelangage employé et la quantité d'espace mémoire disponible pour les tampons quidéterminent cette limite.

NORMES ANSI (American National Standards Institute)

Pour les bandes d'échange, les normes ANSI admettent une longueur minimum de blocde 18 caractères et une longueur maximum de bloc de 2 048 caractères. Tous lessystèmes GCOS 7 peuvent créer et lire des blocs de données dans ces limites.

ARTICLES

Les articles peuvent être de format fixe, variable ou indéterminé (GCOS 7/EBCDICseulement). Pour les bandes d'échange, la longueur maximum d'article doit être limitée àla longueur maximum de bloc autorisée par les normes ANSI (2048 caractères).

TASSEMENT

Il est possible de demander un tassement des caractères espace dans les données desfichiers bande.

Pour ce faire, le paramètre COMPACT = 1 doit être spécifié dans la commandeCREATE_MT_FILE. Cette valeur devient une caractéristique permanente du fichier,enregistrée dans son label.

Dans ce cas, le fichier est soumis aux contraintes suivantes :

• Seul le format variable est autorisé pour les articles.

• La longueur de bloc indiquée par l'utilisateur (BLKSIZE) doit être au moins égale à lalongueur de l'article (RECSIZE) + 4 octets, avec un octet de gestion supplémentairetous les 128 caractères de données.


B-4 47 F2 04UF Rev04

B.2 FORMATS ET LABELS STANDARD

B.2.1 Généralités

GCOS 7 permet la création et le traitement des bandes de formats EBCDIC et ASCII.

LABELS

Les labels sont des blocs spéciaux de 80 caractères, permettant au système d'identifierles bobines (volumes), ainsi que les fichiers et les parties de fichier qui s'y trouventenregistrés.

Tous les labels sont identifiés par leurs quatre premiers caractères :

• les trois premiers caractères indiquent le type du label,

• et le quatrième, le numéro du label pour le type considéré (exemple :HDR2 = deuxième label début de fichier).

Le tableau B-1 indique les différents types de labels, leur signification et leur nombremaximum par bobine, fichier ou partie de fichier suivant les normes GCOS 7/EBCDIC etGCOS 7/ASCII.

Tableau B-1. Types de labels

G C O S 7/EB C D IC G C O S 7 /A S C II

N o m b re m a x im u m

S ig n ifica tionTypes de

labels

8 p a r bo b ine

8 p a r pa rtie defich ie r


8 p a r bo b ine

8 p a r fich ie r


1 p a r b o b ine

9 p a r b o b ine

9 p a r pa rtie d efich ie r

26 p a r p a rtie defich ie r

9 p a r b o b ine

9 p a r fich ie r

26 p a r p a rtie defich ie r

V O L

U V L

H D R

U H L

E O V

E O F

U T L

La be l déb u t de vo lu m e

La be l déb u t de vo lu m e(u tilisa te u r)

La be l dé bu t de fich ie r

La be l dé bu t de fich ie r(u tilisa te u r)

La be l f in de vo lu m e

La be l f in de fich ie r

La be l f in de fich ie r(u tilisa te u r)


47 F2 04UF Rev04 B-5

Le système lit tous les labels (voir figure B-1), mais ne traite que les labels VOL1, HDR1,HDR2, EOF1, EOF2, EOV1 et EOV2. Les autres ne sont pas pris en compte. Pour lacréation des bandes, GCOS 7 utilise les formats présentés à la figure B-2.

MARQUES DE BANDE

C'est le caractère hexadécimal 13 (équivalent du caractère ASCII DC3 et du caractèreEBCDIC TM) qui est utilisé comme marque de bande.

Le système écrit :

• une marque de bande pour séparer les labels des données,

• une pour indiquer une fin de bobine,

• et deux pour indiquer la fin d'un fichier.

Comme elles ne sont pas placées dans le tampon d'entrée lors de leur lecture, leprogrammeur n'a pas à s'en occuper dans le cas des bandes standard.

MARQUES REFLECHISSANTES

Deux marques réfléchissantes sont collées sur la face non magnétisable des bandes :

• La marque BOT signale le début de bande et se trouve à environ 3 mètres du débutphysique de la bande ;

• La marque EOT indique la fin de bande et se trouve à environ 5,50 mètres de la finphysique de la bande.

Ces marques sont détectées par un système de cellules photoélectriques.

FORMAT STANDARD GCOS 7/EBCDIC

C'est le format utilisé par le système pour traiter les bandes en code EBCDIC ou BCD(décimal codé binaire).


B-6 47 F2 04UF Rev04

LABELS DEBUT

On appelle "labels début" les blocs d'identification précédant les données sur les bandesde format standard GCOS 7/EBCDIC.

Tableau B-2. Label début de volume VOL1 (GCOS 7/EBCDIC)

P o sition D e scrip tio nLo ng ue urZ o n e

C o n tien t V O L1 (iden tif ica tio n du lab e ldé bu t de vo lu m e).

C o ntie n t de s in fo rm a tion s fou rn ies pa r le p rog ram m e ur po ur id ent if ie r la b ob ine (1

à 6 ca rac tè res a lp han um ériqu es , c ad ré s à ga uche , a ve c esp aces à d ro ite ).

A c tue llem e n t inu tilisée (p ositio nné e à 0 ).

C on tie n t des espa ces.

C o n tien t d es do nné es fo u rn ies p ar lep rog ram m e ur pou r id en tifie r le p rop rié ta ire du vo lum e. T ous les ca ra ctè res a lph an u-m é riqu es pe uvent ê tre u tilisé s.

C on tie n t des espa ces.

Id ent if ica te ur de labe l

P ro tec tion de vo lu m e

R ése rvée

N o m du p ro p rié ta ire

R éservée

1

5

11

12

42

52

4

6

1

30

10

29

N um érod 'im m a tr icu la tio nde vo lu m e


47 F2 04UF Rev04 B-7

VOL - Label début de volume

Chaque bobine constitue un volume et doit comporter un label début de volume (VOL1)permettant de l'identifier. Ce label, qui est le premier bloc de données écrit sur la bandepar le système, contient les informations détaillées au tableau B-2 ci-dessus.

HDR - Labels début de fichier

Les labels début de fichier (HDR1 et HDR2) sont créés par le système lors de l'ouvertured'un nouveau fichier ou d'une nouvelle partie de fichier. Ils sont automatiquement lus lorsde l'ouverture d'un fichier ou d'une partie de fichier existant déjà. Le label HDR1 contientdes informations destinées au système d'exploitation.

Tableau B-3. Label début de fichier HDR1 (GCOS 7/EBCDIC) (1/2)

LongueurZone D escrip tion

Identifica teur delabel

Identifica teur de fich ie r

N um éro d 'im -m atricu la tion devolum e

N um éro d 'o rdrede volum e

N um éro d 'o rdrede fich ier

N um éro degénération

N um éro devers ion

C ontient HD R1 (identification du label débutde fich ier).

C ontient les 17 caractères de dro ite du nomde fich ier externe. S i ce nom est d 'une longueursupérieure à 17 caractères, les caractères enexcédent sont p lacés dans HD R2.

C ontient l'identificateur du prem ier volum e dufich ier (1 à 6 caractères a lphanum ériques,cadrés à gauche, avec espaces à dro ite).

C ontient le num éro d 'ordre du présent volum e :0001 (décim al) pour un fich ier m onovolum e e tpour le prem ier volum e d 'un fich ier m ultivo lum e.

C ontient le num éro d 'ordre du fich ie r dans unensem ble m ultifich ier : 0001 (décim al) pourun fich ier m onovolum e et pour le p rem ierfich ier d 'un vo lum e m ultifich ier.

C ontient le num éro de généra tion du fich ier(1 à 9999). S i e lle est inutilisée , cette zonecontien t la valeur 0001.

C ontient le num éro de vers ion du fich ie r (0 à99). S i e lle est inutilisée, cette zone contient la valeur 0 .

1

5

22

28

32

36

40

4

17

6

4

4

4

2

Position


B-8 47 F2 04UF Rev04


Lo ng ue urP o sitionZ o n e D e scrip tio n

4 2

4 8

5 4

5 5

6 1

7 4

D ate dec ré ation

D a te dep érem p tio n

Ind ica teu r d ep ro tec tion d ufich ie r

C om p te u r d eb locs

C ode sys tèm e

R éservé e

6

6

1

6

13

7

C o n tie n t la d a te d e cré a tio n d u fic h ie r, sou s lafo rm e su iva n te : e spa ce su iv i de d e ux ca ra c-tè re s n u m é riq u es po u r l'a n n ée , p u is d e tro isca rac tè re s nu m é riq ue s po ur le jou r ca le nd a ire .E x em p le : 9 50 01 = 1e r ja n v ie r 1 99 5 .

C o n tie n t la d a te lim ite de va lid ité d u fich ie r,so us u ne fo rm e id e n tiqu e à ce lle d e la d a te decré a tio n .

C o n tie n t 1 (dé c im a l) s i le fich ie r e st ca ta lo g ué e t 0 da n s le ca s con tra ire .

In u tilis ée .P o s itio n né e à zé ro .

C o n tie n t u n co d e un iq u e id en tif ia n t le sys tè m ed 'e xp lo ita t io n ayan t c ré é le fich ie r. L e fo rm a t d ece co d e es t le su ivan t : G C O S -4 6 4 n n n .nn n es t le num éro de ve rs ion d u s ys tè m e(e xe m p le : 001 , 00 2 , e tc .).

C o n tie n t d es e spa ces .


47 F2 04UF Rev04 B-9

Le label HDR2 contient des informations relatives à l'organisation du fichier. Lorsqu'unebande d'entrée n'a pas de label HDR2, l'utilisateur doit déclarer les valeurs de BLKSIZE,RECSIZE et RECFORM soit dans le programme d'application, soit dans le groupe deparamètres DEFn (équivalent JCL = DEFINE).


LongueurPositionZone Description

1

5

6

11

16

17

18

35

Identificateur delabe l

Identificateur deform at d 'artic le

Longueur debloc

Longueurd 'artic le

Densitéd 'enregistrem ent

Indicateur devolum e in itia l

Identificateurd 'activ ité

Techniqued'enregistrem ent

4

1

5

5

1

1

17

2

Contient H DR 2 (identifica tion de label débutde fich ie r).

Contient un seu l caractère : F , V ou U .

Contient la longueur m axim um de b loc (BSNnon com pris).Longueur m in im um = 00018.

Contient la longueur m axim um d'a rtic le(en-tête d 'a rtic le inc lus).

Code d 'un octe t :2 = D8003 = D16004 = D6250

Code d 'un octe t :0 = prem ier volum e d 'un fich ier m ultivo lum e1 = volum e autre que le prem ier.

Actuellem ent inutilisée. Contien t des espaces.

Contient des espaces indiquant que le fich ierest en EBCDIC /parité im paire


B-10 47 F2 04UF Rev04


LongueurPositionZone D escription

37

38

39

40

53

80

Indica teur detassem ent

Indica teur deBSN

Code de form atde b loc

Réservée

Excédent du nomde fich ie r

Réservée

1

1

1

13

27

1

Contien t C s i les données sont tassées, s inonun espace.

Contien t 1 s'il y a des num éros de b locs (BSN )et 0 dans le cas contra ire. Sous G CO S 7, lavaleur im plic ite est 1.

Indique s i les artic les du fich ie r son t groupés enblocs ou non.Espace = non groupés.B = groupés.

Contien t des espaces.

Contien t les 27 caractères de gauche du nom defich ier externe. S i la longueur de ce nom estinfé rieure ou égale à 17 octe ts, cette zone est àespaces.

Contien t un espace.


47 F2 04UF Rev04 B-11

LABELS FIN

On appelle "labels fin" les blocs d'identification qui suivent les données sur les bandes deformat standard GCOS 7/EBCDIC.

EOF - Labels fin de fichier

Le système génère des labels fin de fichier chaque fois qu'un fichier de sortie est fermé.Dans un fichier d'entrée, les labels fin de fichier indiquent que toutes les données ont ététraitées (fin de fichier). Jusqu'à huit labels fin de fichier peuvent être lus, mais seuls lesdeux premiers sont traités.

Le système compare le nombre de blocs comptabilisés dans ce label avec le nombre deblocs lus au cours du traitement. S'il s'agit d'un fichier multivolume, le nombre figurantdans le label corrrespond au nombre de blocs lus dans le dernier volume seulement. Lecomptage ne porte que sur les blocs de données ; il exclut donc les marques de bande etles labels (système ou utilisateur). Le label EOF1 a le même format que le label HDR1, àquelques différences près (voir tableau B-5).

Tableau B-5. Label fin de fichier EOF1 (GCOS 7/EBCDIC)

Lo ng ue urZ o n e D e scrip tio n

C o n tien t E O F 1 (ide n tif ica tion d e lab e l f in d efic h ie r).

Id e n tiqu e s à H D R 1 .

C o n tien t u n n om bre d é c im a l in d iq ua n t len o m b re d e b lo cs d u fic h ie r (f ich ie rs m o n o vo -lu m es ) o u de la pa rtie de fich ie r c on s idé ré e(fich ie rs m u ltivo lu m e s).

Id e n tiqu e s à H D R 1 .

1

5

55

61

4

50

6

20

Id e n tif ica teu r delab e l

A u tres zon es

C o m p te u r d eb lo cs

A u tres zon es

P o sitionre la tive

Le label EOF2 est identique au label HDR2, à l'exception de l'identificateur.


B-12 47 F2 04UF Rev04

EOV - Label fin de volume

Le système génère des labels fin de volume en fin de bobine, lorsque le fichier considérécontinue sur une autre bobine. Dans un fichier d'entrée, les labels fin de volume indiquentque toutes les données d'une partie de fichier ont été traitées (fin de partie). Jusqu'à huitlabels fin de volume peuvent être lus, mais seul le premier est traité.

Le système compare le nombre de blocs comptabilisés dans ce label aux nombre deblocs lus au cours du traitement de la partie de fichier considérée. Le comptage ne porteque sur les blocs de données ; il exclut donc les marques de bande et les labels (systèmeou utilisateur). Le label EOV1 a le même format que le label HDR1, à quelquesdifférences près (voir tableau B-6).

Tableau B-6. Label fin de volume EOV1 (GCOS 7/EBCDIC)

Lo ng ue urZ o n e D e scrip tio nP o sitionre la tive

Id e n tif ica te u r d elab e l

A u tre s zon es

N o m b re d eb lo cs

A u tre s zon es

1

5

55

61

4

5 0

6

2 0

C o n tien t E O V 1 (id e n t if ica tio n d e la b e l f in d evo lum e ).

Id e n t iqu e s à H D R 1 .

C o n tien t u n n om bre d éc im a l in d iq u a n t len o m b re de b lo cs o ccu p és p a r le fich ie r da ns levo lu m e .

Id e n t iqu e s à H D R 1 .

Le label EOV2 est identique au label HDR2, à l'exception de l'identificateur.


47 F2 04UF Rev04 B-13

FORMATS DE VOLUMES

La figure B-1 montre les formats de volumes reconnus conformes à GCOS 7/EBCDIC.GCOS 7 lit tous les labels, mais ne traite que VOL1, HDR1, HDR2, EOF1, EOF2, EOV1et EOV2, les autres n'étant pas pris en compte.

Lorsqu'un volume bande sans labels ($NONE) est accepté en entrée par la fonction AVR(Automatic Volume Recognition = reconnaissance automatique de volume), le systèmed'accès considère que la bande contient une série de blocs de données limitée par uneseule marque de bande indiquant la fin du fichier.

VO L1-8

H DR1-8

U HL1-8

TM

TM

EO F1-8

UTL1-8

TM

TM

TM

VO L1-8

H DR1-8

U HL1-8

TM

TM

UTL1-8

TM

EO V1-8

VO L1-8

H DR1-8

U HL1-8

TM

TM

EO F1-8

UTL1-8

TM

TM

VO L1-8

H DR1-8

U HL1-8

TM

U TL1-8

TM

HD R1-8

UH L1-8

TM

TM

EO F1-8

U TL1-8

TM

TM

EO F1-8

TM

Fichie r m onovolum e avec labe ls

BLO CS DE DO N NEES D U FIC HIER

Fichie r m onovolum e sans labe ls ($N O NE)

BLO CS D E D O NN EES DU FICH IER

Fichie r m ultivo lum e

BLO C S D E DO NN EES D U PREM IER VO LUM E

BLO CS DE DO N NEES D U D ER NIER VO LU M E

Volum e m ultifich ier

F ich ierA

F ichie rB

Figure B-1. Formats reconnus conformes à GCOS 7/EBCDIC (1/2)


B-14 47 F2 04UF Rev04

VO L1-8

HD R1-8

UH L1-8

TM

UTL1-8

TM

HDR1-8

U HL1-8

TM

TM

EO F1-8

F ichierA

Ensem ble m ultivo lum e/m ultifich ier

PREM IER E PARTIE D UFIC HIER B

TM

TM

VO L1-8

HD R1-8

UH L1-8

TM

EO V1-8

UTL1-8

D ER NIERE PARTIE DU FIC HIER B

TM

U TL1-8

TM

HD R1-8

UH L1-8

TM

EO F1-8

U TL1-8

TM

TM

EO F1-8

TM

FichierC

Figure B-1. Formats reconnus conformes à GCOS 7/EBCDIC (2/2)

Remarque : Pour qu'un ensemble de labels soit reconnu conforme à GCOS7/EBCDIC (ANSI=0 dans la commande CREATE_MT_FILE etDATACODE=EBCDIC dans le groupe de paramètres DEFn) il doitcomprendre VOL1, HDR1, EOF1 et EOV1. HDR2, EOF2 ou EOV2ne sont pas obligatoires, mais sont également traités s'ils existent.


47 F2 04UF Rev04 B-15

TM

TM

TM

TMH D R 2H D R 1 E O F1 EO F2VO L 1

TMH D R 1VO L 1

TM

TM

TMH D R 2H D R 1VO L 1 EO V 1 E O V2

TM

TMH D R 2VO L 1

TM

TM

TMH D R 1 H D R 2H D R 1E O F2EO F1

TM

TME O V1 E O V 2

TMH D R 2V O L1

TM

TM

TMH D R 1 H D R 2H D R 1E O F2EO F1

TM

TME O F1 E O F2

TM

Volu m e con tena n t un fich ie r m on ovo lum e ou la d ern iè re partie d 'un fich ie r m u ltivo lu m e.

Vo lu m e con tena n t une pa rtie in te rm é d ia ire d 'un fich ie r m u ltivo lum e.

F ich ie r m on ovo lum e san s labe ls ($N O N E ) : G C O S 7 /EB C D IC se u lem en t.

V o lum e d 'un ensem ble m u ltivo lum e /m u ltifich ie r

B locs de don -née s du fich ie r A

V o lum e m ultifich ie r

B locs de don -née s du fich ie r A

Vo lu m e v ide avec labe ls , ap rès exécu tion de PR EP AR E_ T AP E (P R P T P)

B locs de donn ées

B locs de donn ées

B locs de donn ées

B locs de don née s de la p rem iè re p artie d u fich ie r B

B locs de données du fich ie r B

Figure B-2. Formats créés par GCOS 7


B-16 47 F2 04UF Rev04

B.2.2 Format standard GCOS 7/ASCII

C'est le format utilisé par le système pour traiter les bandes en code ASCII.

LABELS DEBUT

On appelle "labels début" les blocs d'identification précédant les données sur les bandesde format standard GCOS 7/ASCII.

Tableau B-7. Label début de volume VOL1 (GCOS 7/ASCII)


1

5

11

12

38

52

80

4

6

1

26

14

28

1

Identificateur delabel

N um éro d 'im m a-tricu lation devolum e

Accès auvolum e

R éservée

N om dupropriéta ire

R éservée

Version de lanorm e régissantles labe ls

C ontient VO L1 (identification du labe l début devolum e).

C ontient un code d 'iden tification unique, fourn ipar l'u tilisateur (1 à 6 caractères a lphanum é-riques cadrés à gauche, avec espaces àdroite).

C ontient un caractère a lphanum érique indi-quant les restric tions d 'accès au volum e. Unespace ind ique l'absence de restric tions.

C ontient des espaces.

C ontient des caractères a lphanum ériquesidentifian t le proprié ta ire.Valeur im plicite = espaces.

C ontient des espaces.

3 = version 1974 de la norm e internationa le(ISO /1001).C 'est la vers ion actuellem ent générée par G CO S 7.1 ,2 = versions antérieures de la norm ein ternationa le.


47 F2 04UF Rev04 B-17

VOL - Label début de volume

Chaque bobine constitue un volume et doit comporter un label début de volume (VOL1)permettant de l'identifier. Ce label, qui est le premier bloc de données écrit sur la bandepar le système, contient les informations détaillées au tableau B-7 ci-dessus.

HDR - Labels début de fichier

Les labels début de fichier (HDR1 et HDR2) sont créés par le système lors de l'ouvertured'un nouveau fichier ou d'une nouvelle partie de fichier. Ils sont automatiquement lus lorsde l'ouverture d'un fichier ou d'une partie de fichier existant déjà. Le label HDR1 contientdes informations destinées au système d'exploitation.

Tableau B-8. Label début de fichier HDR1 (GCOS 7/ASCII) (1/2)

LongueurZone Description


Identificateur defich ier

Num éro d 'im m atri-cu lation de vo lum e

Num éro d 'ordrede volum e

Num éro d 'ordre de fich ie r

Num éro degénéra tion

Num éro devers ion

Date de création

Positionre lative

1

5

22

28

32

36

40

42

4

17

6

4

4

4

2

6

C ontient HD R1 (identification du labe l début defich ier)

C ontient le nom de fich ie r externe. Pour lesfich iers bande ASCII, ce nom ne peut excéder17 caractères.

C ontient l'identificateur du prem ier volum e dufich ier.

C ontient le num éro d 'ordre du présent volum e:0001 (décim a l) pour un fich ier m onovolum e e tpour le prem ier volum e d 'un fich ierm ultivo lum e.

C ontient le num éro d 'ordre du fich ie r dans un ensem ble m ultifich ier : 0001 pour un fich ierm onovolum e e t pour le p rem ier fich ier d 'un volum e m ultifich ie r.

C ontient le num éro de généra tion du fich ier(0001 à 9999). La valeur im plicite est 0001 (pas de générations).

C ontient le num éro de vers ion du fich ie r (00 à99). S i e lle est inutilisée, cette zone est à zéro.

C ontient la date de création du fich ier, sous laform e suivante : espace suivi de deux carac-tères num ériques pour l'année, puis de tro iscaractères num ériques pour le jour calendaire.


B-18 47 F2 04UF Rev04

Tableau B-8. Label début de fichier HDR1 (GCOS 7/ASCII) (2/2)

LongueurZone Description

Date depérem ption

Indicateur de pro-tection du fich ier

Com pteur deblocs

Positionre lative

48

54

55

6

1

6

C ontien t la date lim ite de valid ité du fich ie r,sous une form e identique à celle de la date decréation.

C ontien t 1 (décim a l) s i le fich ier est cata logué,e t des espaces dans le cas contra ire.

Inu tilisée.C ontien t 0.


47 F2 04UF Rev04 B-19

Le label HDR2 contient des informations relatives à l'organisation du fichier. Son formatest présenté dans le tableau B-9 ci-après.

Tableau B-9. Label début de fichier HDR2 (GCOS 7/ASCII)

LongueurPositionZone D escription

Identificateur delabel

Ind icateur deform at d 'artic le

Longueur deb loc

Longueur d 'artic le

R éservée

Ind icateur de BSN

R éservée

1

5

6

11

16

51

53

4

1

5

5

35

2

28

Contient H DR 2 (identifica tion de label début defich ier).

Contient un seu l caractère : F pour longueurfixe, ou V pour longueur variable.

Contient la longueur m axim ale de b loc, en-têtede b loc com pris .Valeur m in im um = 00018.

Contient la longueur m axim um d'artic le, en-tê ted 'artic le com pris.

Contient des espaces.

Indique la p résence ou l'absence de num érosde b locs (BSN )0 = pas de BSN6 = BSN de n iveau 64-665 = BSN de n iveau 61 .

Contient des espaces.

LABELS FIN

On appelle "labels fin" les blocs d'identification qui suivent les données sur les bandes deformat standard GCOS 7/ASCII.

EOF - Labels fin de fichier

Le système génère ces labels à la fermeture de chaque fichier de sortie. Dans un fichierd'entrée, ils indiquent que toutes les données ont été traitées (fin de fichier). Jusqu'à 9labels fin de fichier peuvent être lus, mais seuls les deux premiers sont traités.

Le système compare le nombre de blocs comptabilisés dans ce label au nombre de blocslus au cours du traitement. S'il s'agit d'un fichier multivolume, le nombre figurant dans lelabel correspond au nombre de blocs lus dans le dernier volume seulement. Le comptagedes blocs ne porte que sur les blocs de données ; il exclut donc les marques de bande etles labels (système ou utilisateur). Le label EOF1 a le même format que le label HDR1, àquelques différences près (voir tableau B-10).


B-20 47 F2 04UF Rev04

Tableau B-10. Label fin de fichier EOF1 (GCOS 7/ASCII)


Contien t EO F1 (identification de labe l fin defich ier).

Identique à HD R1.

Contien t un nom bre décim a l indiquant le nom -bre de b locs du fich ier (fich iers m onovo lum e)ou de la partie de fich ier considérée (fich ie rsm ultivo lum es).

Identique à HD R1.


Autres zones

Com pteur de b locs

Autres zones

1

5

55

61

4

50

6

20

Le label EOF2 est identique au label HDR2, à l'exception de l'identificateur.

EOV - Labels fin de volume

Le système génère des labels fin de volume en fin de bobine, lorsque le fichier considéré(ou le dernier fichier d'un ensemble multivolume multifichier) continue sur une autrebobine. Dans un fichier d'entrée, les labels EOV indiquent que toutes les données d'unepartie de fichier ont été traitées (fin de partie). Jusqu'à neuf labels fin de volume peuventêtre lus, mais seul le premier est traité.

Le système compare le nombre de blocs comptabilisés dans ce label au nombre de blocslus au cours du traitement de la partie considérée du fichier. Le comptage ne porte quesur les blocs de données ; il exclut donc les marques de bande et les labels (système ouutilisateur). Le label EOV1 a le même format que le label EOF1, à l'exception del'identificateur.

FORMATS DE VOLUMES

La figure B-3 ci-dessous montre les formats de volumes reconnus conformes àGCOS 7/ASCII. Le système lit tous les labels, mais ne traite que VOL1, HDR1, HDR2,EOF1, EOF2 et EOV1. Les autres labels ne sont pas pris en compte.


47 F2 04UF Rev04 B-21

TM

TM

TM

TM

Fichier m ultivo lum e

Volum e m ultifich ie r

F ich ierA

F ichierB

Ensem ble m ultivo lum e/m ultifich ier

F ichierC

Fichier m onovolum e

VO L1

U VL1-9

H DR1-9

EO F1-9

TM

VO L1

U VL1-9

H DR1-9

TM

TM

EO F1-9

TM

VO L1

U VL1-9

H DR1-9

TM

TM

EO F1-9

TM

VO L1

U VL1-9

H DR1-9

TM

TM

EO F1-9

TM

TM

EO F1-9

UTL1-26

TM

Fich ierA

TM

VO L1

U VL1-9

H DR1-9

TM

TM

EO F1-9

TM

H DR1-9

TM

TM

VO L1

U VL1-9

H DR1-9

TM

TM

EO F1-9

UTL1-26

TM

HDR1-9

TM

TM

EO F1-9

UTL1-26

TM

B locs de données du fich ie r

B locs de données du prem ier volum e

Blocs de données du dern ier volum e

UH L1-26

UH L1-26

UH L1-26

TM

UH L1-26

TM

TM

H DR1-9

U HL1-26

UH L1-26

U HL1-26 Prem ière partie du fich ier B

Dernière partie dufich ier B

U HL1-26

U HL1-26

U TL1-26

EO F1-9

U TL1-26

UTL1-26

UTL1-26

UTL1-26

UTL1-26

Figure B-3. Formats reconnus conformes à GCOS 7/ASCII


B-22 47 F2 04UF Rev04

47 F2 04UF Rev04 C-1

C. Fichiers séquentiels indexés -Représentation hexadécimale des espaces

adresses

Les exemples fournis dans cette annexe doivent permettre à l'utilisateur d'analyser lesvidages en hexadécimal des différents espaces adresses de ses fichiers séquentielsindexés, pour la mise au point des CI.

Error! Bookmark not defined. Ces exemples sont constitués de portions de vidagesignificatives portant sur différents fichiers VBO. A noter que les fichiers FBO comptent unoctet supplémentaire avant chaque en-tête de CI et un autre en fin de CI.


C-2 47 F2 04UF Rev04

1 2 3 4 5 6 7 8

07DA0026

0200C3C1

C3C1F2F4

F0F0F6F8

F4F20000

00000F00

1200C3F7

C3F7F4F5

F5F2F3F0

00000000

F2F0F0F2

F4F20000

00000900

0C00C3F6

C3F7F2F6

F3F9F7F2

F1F30000

00001900

00C70000

00000300

0600C3C1

C3C3F2F1

F1F6F3F8

F6F60000

00001300

1600C3F7

C3F7F5F5

F1F1F8F1

F1F70000

00000700

0A00C3C6

C3F6F6F3

F3F2F9F8

F6F10000

00001700

F8F70000

00000500

0800C3C3

C3C6F2F1

F8F9F0F4

F8F40000

00001500

1800C3F7

C3C1F1F8

F2F2F9F2

F9F20000

00000B00

0E00C3F6

C3F7F3F7

F4F2F8F2

F9F90000

00000100

0400C3C1

C3C1F2F7

F0F7F4F7

F5F10000

00001100

1400C3F7

C3F7F4F9

CI d'index (espaces adresses 3, 4, 6 et 7)

0000C3C1

C3C1F2F2

F2F6F5F8

F3F60000

00000D00

1000C3F7

C3F7F4F1

F4F7F4F2

F1F80000

En-tête de CI (10 octets)

(1) Espace occupé dans le CI : 2018 octets (2016 pour un fichier FBO)

(2) Espace libre dans le CI (en octets) ; la taille de CI est de 2048 octets.

(3) Type de clé : 00 = clé primaire (index primaire) ; 01 = céls secondaires (indexsecondaire)

(4) Numéro du CI dans l'espace adresses. Le Ci représenté ci-dessus est le 1er (N°000000)

(5) Numéro de la ligne du dernier article (rubrique d'index) actif du CI : numéro 00C7.

Rubrique d'index

(6) Numéro du CI de niveau inférieur contenant la clé la plus élevée. Par exemple, un CId'index.

(7) Etat du CI : 00 = le CI contient un ou plusieurs articles valides ; 80 = le CI ne contientque des articles supprimés.

(8) Valeur de clé la plus élevée du CI d'index de niveau immédiatement inférieur :C3C1F1F1F8F1.

Il n'y a qu'un seul en-tête de CI, mais plusieurs rubriques d'index.

Fichiers séquentiels indexés - Représentation hexadécimale des espaces adresses

47 F2 04UF Rev04 C-3

075B00A5

40404040

40404040

F2404040

40404040

00CD03F1

40404040

D440E2E3

00000000

40404040

40404040

404040C6

40404040

C3F0F9F1

40C3C1F0

C1C3D2D6

00080008

40404040

4040F34B

404040C4

40404040

F0F0F940

E5F24040

D5C740F1

40100000

F1404040

E8D5C1C4

40404040

40404040

40404040

CD02C34B

40404040

4040D3D6

40404040

40404040

C6E6F6F0

F3F44BF0

C3C1F0F3

C1C4C9D5

40404040

40404040

F3404040

1 2 3 4 5 6 7 8 9 10 11 12

131415

F3F8C340

F5F8C340

C740E2D4

40401000

40404040

E3C1E2D2

CI de données (espace adr esses 2)

40404040

40404040

E6F6F0F7

40404040

F2F0C3F0

F4F0F940

E540D9C9

40404040

FFE740D7

D3C5C440

404040C3

4040C6E6

40E6C8C5

D54BE2E3

40404040

00000000

059B04CE

40404040

D961C3D9

40404040

C1F1F1F8

F6F0F240

D540C46B

C54BE2D9

40404040

00000000

04010334

40404040

40C961D6

40404040

F1404040

4040D4C9

D76BD14B

C16BD3C7

40404040

00000000

0267019A

100000CD

40C6C1C9

40404040

40404040

E9D6D740

D74BE2E3

40404040

40404040

00000668

00CD0000

40404040

40404040

40404040

E3D94040

40404040

40404040

00000000

40404040

4040C3C1

40C6E6F6

40404040

40404040

40404040

00000000

40404040

F0F8F7F6

F3F54040

40404040

40404040

40000000

00000000

40404040

40E5F340

40D6D7D9

40404040

40404040

00000000

00000000

0000 FFFF FF000001 100000CD 01404040 40404040


C-4 47 F2 04UF Rev04

Les article ayant une largeur importante, seule une partie du CI de données estreprésentée ici.


(1) Espace occupé dans le CI (en octets).

(2) Espace libre dans le CI (en octets).

(3) Type de clé (toujours à 00).

(4) Numéro du CI dans l'espace adresses. Le CI représenté ci-dessus est le 1er (N°000000)

(5) Numéro de ligne du dernier article enregistré (valide ou supprimé) du CI : 0008.

(6) Numéro de ligne du dernier article valide du CI. Si le CI est vide, cette zone est àFFFFFF.

(7) Numéro de ligne du premier article du CI : 0000.

(8) Réservé.

(9) Numéro du CI suivant. Dans cet exemple, il s'agit du CI 000001. Si ce CI est ledernier, la zone est à FFFFFF.

En-tête d'article (5 octets)

(10) Etat de l'article : 1 = article valide ; 0 = article supprimé.

(11) Longueur de l'article, en-tête compris : 205 octets.

(12) Numéro de l'article suivant. Si l'article a la valeur de clé la plus élevée du CI cettezone est à FF.

Descripteurs d'articles (2 octets chacun)

(13) Descripteur du premier article

(14) Descripteur du deuxième article

(15) Descripteur du troisième article.

Chaque descripteur indique le déplacement de l'article par rapport au début de la partiedonnée du CI.

Fichiers séquentiels indexés - Représentation hexadécimale des espaces adresses

47 F2 04UF Rev04 C-5

1 2 3 4 5 6 78 9

00A6075A

00000000

0400FFFF

00000000

00090000

00000000

FFFFFF00

00000000

00FFFFFF

00040000

C6E6F6F1

FFFFFF00

00000000

00000000

FF000000

00000000

FFFF0000

00000000

0000C6E6

F8FFFFFF

00050000

00000000

00000A00

00000000

00FFFFFF

00000000

0000FFFF

F5F4F700

FF000003

00000000

00000000

00000000

000000FF

00000000

00000000

00000000

00C6E6F6

00000000

00000000

00000000

FFFF0000

00000000

FFFFFF00

000100C6

F3F3FFFF

00000600

00000080

0000000B

00000000

0000FFFF

00000000

E6F6F0F7

FFFF0000

00000000

00000000

00000000

00000000

FF000000

00000000

00000200

FFFFFFFF

00000007

00000000

0000FFFF

00000000

000000FF

00000000

01000000

CI d'index dense (espace adresses 5)


C-6 47 F2 04UF Rev04


(1) Espace occupé dans le CI (en octets)

En-tête d'article

(2) Etat de l'article :

0001 (1) = article valide.0000 (0) = article supprimé.

(3) Réservé (12 bits).

(4) Indicateur d'articles synonymes :

00 la valeur de clé est unique (aucun autre article n'a la même).01 et article est le premier d'un groupe d'articles ayant la même valeur de clé.11 et article est un article intermédiaire dans un goupe d'articles ayant la même

valeur de clé.10 et article est le dernier d'un groupe d'articles ayant la même valeur de clé

(5) Longueur de l'article en-tête compris

(6) Numéro de l'article suivant. Si cet article a la clé la plus élevées du CI, la zone est àFF.

(7) Clé.

(8) Rang de l'article dans le groupe ayant même valeur de clé, si l'indicateur figurant en(4) est différent de 00.

(9) Espace SFRA* de longueur variable. Contient les adresses des articles de donnéesayant la même valeur pour la clé secondaire figurant en (7). SFRA = numéro de CIdonnées (3 octets) + numéor de ligne (1 octet) de l'article associé dans l'espaceadresse 2.

(SFRA = Simple File Relative Address - Méthode simple d'adressage relatif pour lesfichiers).

47 F2 04UF Rev04 D-1

D. Correspondance GCL/JCL

Les deux tableaux fournis dans cette annexe permettent d'établir la correspondance entreordres JCL et commandes GCL (et inversement).

Tableau D-1. Correspondances JCL/GCL (1/2)

CM PFCM PFST

LDFLDFST

DLFDLFST

CR FCR FST

CPFCPFST

LSFLSFSTLSFSP

M NF

CLR FM DFSTATM DF

C O M PAR E

C REATE

D EALLO C

FILALLO C

FILDU PLI

F ILLIST

FILM AIN T

FILM O D IF

JC L G CL

CO M PARE_FILECO M PARE_FILESET

LO AD_FILELO AD_FILESET

DELETE_FILEDELETE_FILESET

CREATE_FILECREATE_FILESET

CO PY_FILECO PY_FILESET

LIST_FILELIST_FILESETLIST_FILE_SPACE

M AINTAIN_FILE

CLEAR_FILEM O DIFY_FILE_STATUSM O DIFY_FILE

Abréviation


D-2 47 F2 04UF Rev04

Tableau D-2. Correspondances JCL/GCL (2/2)

JC L G CL

RESTO RE_C ATALO GRESTO RE_FILERESTO RE_FILESET

SAVE_CATALO GSAVE_FILESAVE_FILESET

BU ILD_LIBRAR Y

CLEAR_LIBR AR YDELETE_LIBR ARY

M ER G E_FILE

BU ILD_FILECREATE_M T_FILEM O DIFY_FILE_SPACE

PR IN T_FILEPR IN T_FILESET

EXPAN D_FILESET

SO R T_FILE

SO R T_IND EX

LIST_VO LUM E

M AINTAIN_VO LUM E

M O DIFY_DISK

CLEAR_VO LUM EPR EPARE_D ISKPR EPARE_TAPE

RESTO RE_D ISK

SAVE_DISK

FILREST

FILSAVE

LIBALLO C

LIBDELET

M ERG E

PREALLO C

PRINT

SETLIST

SO RT

SO RTID X

VO LLIST

VO LM AINT

VO LM O D IF

VO LPR EP

VO LR EST

VO LSAVE

RSTCATRSTFRSTFST

SVC ATSVFSVFST BLIB

CLR LIBDLLIB M RG F

BFCR M TFM DFSP

PR FPR FST

EXPFST

SR TF

SR TID X

LSV

M NV

M DD

CLR VPR PDPR PTP

RSTD

SVD

Abréviation

Correspondance GCL/JCL

47 F2 04UF Rev04 D-3

Tableau D-3. Correspondances GCL/JCL (1/2)

BF

BLIB CLR F

CLR LIB

CLR V

CM PF

CM PFST

CPF

CPFST

CR F

CR FST

CR CTF

CR M TF

DLF

DLFST

DLLIB

EXPFST

LSF

LSFST

LSFSP

LSV

LDF

LDFST

BU ILD_FILE

BU ILD_LIBR AR Y

CLEAR_FILE CLEAR_LIBR AR Y

CLEAR_VO LUM E

CO M PARE_FILE

CO M PARE_FILESET

CO PY_FILE

CO PY_FILESET

CR EATE_FILE

CR EATE_FILESET

CR EATE_C T_FILE

CR EATE_M T_FILE

DELETE_FILE

DELETE_FILESET

DELETE_LIBRARY

EXPAN D_FILESET

LIST_FILE

LIST_FILESET

LIST_FILE_SPACE

LIST_VO LUM E

LO AD_FILE

LO AD_FILESET

PREALLO C

LIBALLO C

FILM O DIF

LIBD ELET

VO LPREP

CO M PARE

CO M PARE

FILDU PLI

FILDU PLI

F ILALLO C

FILALLO C

PREALLO C

PREALLO C

DEALLO C

DEALLO C

LIBD ELET

SETLIST

FILLIST

FILLIST

FILLIST

VO LLIST

CR EATE

CR EATE

G C L JC LAbréviation


D-4 47 F2 04UF Rev04

Tableau D-4. Correspondances GCL/JCL (2/2)

M AINTAIN_FILE

M AINTAIN_VO LUM E

M ER G E_FILE M O DIFY_DISK

M O DIFY_FILE

M O DIFY_FILE_SPACE

M O DIFY_FILE_STATU S

PR EPAR E_DISK

PR EPAR E_TAPE

PR EPAR E_VO LUM E

PR IN T_FILE

PR IN T_FILESET

RESTO RE_C ATALO G

RESTO RE_D ISK

RESTO RE_FILE

RESTO RE_FILESET

SAVE_CATALO G

SAVE_DISK

SAVE_FILE

SAVE_FILESET

SO RT_FILE

SO RT_IND EX

M N F

M NV

M RG F

M DD

M DF

M DFSP

M DSTAT

PR PD

PR PTP

PR PV

PR F

PR FST

RSTCAT

RSTD

RSTF

RSTFST

SVC AT

SVD

SVF

SVFST

SR TF

SR TID X

FILM AINT

VO LM AIN T

M ER G E

VO LM O D IF

FILM O DIF

PREALLO C

FILM O DIF

VO LPREP

VO LPREP

VO LPREP

PRINT

PRINT

FILREST

VO LREST

FILREST

FILREST

FILSAVE

VO LSAVE

FILSAVE

FILSAVE

SO RT

SO RTIDX

G C L JCLAbrévia tion

47 F2 04UF Rev04 E-1

E. Opérations internes sur les tampons

Comme indiqué au chapitre 5, trois paramètres permettent à l'utilisateur d'optimiser lagestion des tampons : POOLSIZE, NBBUF et BUFPOOL. La présente annexe fournit uncomplément d'informations d'une part sur les opérations internes relatives aux tampons,et d'autre part, sur les ressources mémoire impliquées.

Algorithme UFAS-EXTENDED de gestion des tampons

Error! Bookmark not defined. Pour chaque fichier ouvert, on a :

• 1 tampon actif (busy),

• 1 à n tampons mémorisés (remember),

• 1 à n tampons vides (empty).

Un tampon "actif" contient un CI en cours d'accès.Un tampon "mémorisé" contient un CI conservé en mémoire en vue de sa réutilisation. Laréactivation d'un tampon mémorisé permet d'éviter une opération de lecture physique.Un tampon "vide" contient des informations non pertinentes, par exemple après arrêtprématuré d'une unité de consolidation.

Lorsqu'un programme doit traiter un article, UFAS-EXTENDED commence parrechercher cet article dans les tampons mémorisés. S'il le trouve, il réactive le tampon quile contient. La recherche est terminée et l'article peut être traité. La réactivation al'avantage d'économiser une E/S physique, ou même deux s'il a fallu réécrire un CImodifié.


E-2 47 F2 04UF Rev04

UFAS-EXTENDED comptabilise et imprime dans l'historique de travail (JOR) le nombred'accès effectués dans le tampon actif et dans les tampons mémorisés réactivés, c'est-à-dire le nombre d'accès n'ayant pas nécessité d'opérations d'E/S physiques (rubriqueHITCOUNT).

Si l'article n'est pas dans un tampon mémorisé, le CI qui le contient doit être transféré dufichier en mémoire principale.

Pour loger les CI à transférer (CI de données ou d'index), UFAS-EXTENDED recherchela place nécessaire dans l'espace mémoire réservé aux tampons. L'algorithme simplifiéest décrit dans l'organigramme de la figure E-1.

Si le nombre maximum de tampons (NBBUF) n'est pas atteint, et s'il reste de la place enmémoire tampon (valeur de POOLSIZE pas encore atteinte), UFAS-EXTENDED crée unnouveau tampon. S'il ne reste plus de place en mémoire tampon (valeur de POOLSIZEatteinte), UFAS-EXTENDED supprime un ou plusieurs tampons afin de libérer la placenécessaire.

Opérations internes sur les tampons

47 F2 04UF Rev04 E-3

C I dans le poolde tam pons?

Ta ille m axim ém oire tam pon

(PO O LSIZE)atte in te?

Y-a-t-il un tam ponvide ou m ém orisé

de ta ille =?•Y-a-t-il un tam ponvide ou m ém orisé

de ta ille =?


de ta ille >?

Supprim er n tam pons

(+ n SEG DL)


de ta ille <?

Début recherche de C I(+1 G ETCICO UNT)

Nb m axitam pons (NBBUF)

atte int?

Le contenu dunouveau C I

recouvrecelu i de l'ancien

BU FNAV ou CM W SO V

C réer un tam pon(+1 SEG CR )

(+1 H ITCO U NT)

B

B

A

A

B

O ui

Non

O ui

N on

O ui

O ui

N on

Non

N on

Non

O ui

N on

Supprim er untam pon de ta ille =

(+1 SEG DL)

Lire le C I(+ 1 READIO CT)

Lire le C I (+ 1 READIO C T)

Traitem ent

Figure E-1. Opérations internes sur les tampons

Référence i-4

47 F2 04UF Rev04 F-1

F. Paramétrage des fichiers UFAS sous UFAS-EXTENDED

Error! Bookmark not defined. Cette annexe est destinée aux utilisateurs souhaitantcréer des fichiers UFAS sous UFAS-EXTENDED au moyen de PREALLOC avecVERSION = PREVIOUS.

Compatibilité entre UFAS-EXTENDED et UFAS

Error! Bookmark not defined. Pour des raisons de compatibilité, UFAS-EXTENDEDaccepte toujours les anciens fichiers UFAS. Il est cependant préférable de les convertir aunouveau format à blocs fixes.

Des systèmes couplés doivent obligatoirement exploiter la même version UFAS,car ni la fonction de partage dynamique des fichiers, ni la fonction de relance enexploitation transactionnelle (TCRF) ne sont disponibles d'une version à l'autred'UFAS.

Si un fichier est instable dans une version donnée, il doit être reconstitué dans cetteversion.

Depuis la version 6, VERSION = PREVIOUS ne peut être utilisé que dans l'ordre JCLPREALLOC, mais pas dans la commande BUILD_FILE.

Caractéristiques d'UFAS

La taille d'un CI d'index peut être différente de celle d'un CI de données, car UFAS utilisela valeur du paramètre CASIZE pour effectuer les calculs.

UFAS admet jusqu'à 18.500 tampons par application TDS lorsque VERSION =PREVIOUS.

Le nombre maximum de fichiers partageables au niveau système est de 800, et lenombre de fichiers pouvant être ouverts simultanément pour une application TDS de 500.


F-2 47 F2 04UF Rev04

CA (ZONE DE CONTROLE)

Error! Bookmark not defined. Le CA (Control Area) est constitué d'un ou plusieurs CI(Control Intervals). C'est l'unité d'extension des fichiers séquentiels indexés. Dans unfichier donné, tous les CA contiennent le même nombre de CI. Seuls les CI des espacesadresses 2 (données) et 5 (index secondaires niveau dense) sont regroupés en CA. Lenombre de CI par CA est défini par l'utilisateur à la création du fichier (voir ordrePREALLOC). UFAS-EXTENDED affecte les CA au fur et à mesure des besoins.

Choix de CASIZE

CASIZE est le nombre de CI de données par CA. Cette valeur détermine le nombre derubriques contenues dans un CI d'index. La valeur de CASIZE doit en général être la plusgrande possible, dans les limites suivantes :

20 <= CASIZE <= 100

L'utilisateur peut néanmoins fixer une valeur supérieure à 100, si cela permet d'éliminerun niveau d'index (donc de réduire le nombre d'opérations E/S au cours du traitement).

Supposons, par exemple, que CISIZE = 4096 et CASIZE = 100. Le tableau 6-1 montreque pour une unité de disques MS/D500, il y a 144 CI par cylindre. Dans ce cas, un CAcorrespondra donc à un cylindre environ.

Si CASIZE est omis, UFAS-EXTENDED lui affecte une valeur à la première ouverture dufichier. Cette valeur est calculée pour que le CA tienne dans un cylindre moins deuxpistes, avec CAFSP=0.

Si l'utilisateur souhaite conserver un certain pourcentage d'espace libre dans chaque CAlors du chargement initial, il doit spécifier le paramètre CAFSP de l'ordre PREALLOC. Lavaleur de CAFSP correspond à un pourcentage du nombre de CI constituant le CA.

Insertion de masse

Error! Bookmark not defined. Ce processus n'est pas disponible pour les fichiers UFASavec VERSION = PREVIOUS.

Paramétrage des fichiers UFAS sous UFAS-EXTENDED

47 F2 04UF Rev04 F-3

Exemple de réservation de place pour un fichier UFAS (VERSION = PREVIOUS)

PREALLOC R.HANS:V1:MS/D500 Création du fichier R.HANS dans le volumeV1 sur MS/D500.

UFAS = INDEXEDSIZE = 5000 UNIT = RECORDINCRSIZE = 1000CISIZE = 2048CIFSP = 25

RECSIZE = 120KEYLOC = 1KEYSIZE = 4VERSION = PREVIOUSCASIZE = 30CAFSP = 10;

Ce fichier a une taille de 5000 articles, unincrément de 1000 articles, une taille de CIde 2048 octets. Le CI comporte 25%d'espace libre (pour insertion ultérieure de 4articles). La longueur d'article est de 120octets. La clé, d'une longueur de 4 octets,commence à l'octet 1. Le fichier est auformat UFAS. Un CA contient 30 CI, et 10%d'espace libre (pour insertion ultérieurede 3 CI).


F-4 47 F2 04UF Rev04

47 F2 04UF Rev04 G-1

G. Batch Booster (Optimiseur d'E/STraitement par lots)

Error! Bookmark not defined.Error! Bookmark not defined. G.1PRESENTATION

L'option Batch Booster (Optimiseur d'E/S Traitement par lots) apporte une améliorationimportante au niveau des performances d'entrée/sortie. Elle permet en effet des E/Sdisques multiblocs - et non plus bloc par bloc -, d'où un gain de temps ELAPSED (tempstotal écoulé) et CPU (temps processeur).

Batch Booster est également appelé option BPB (blocks per buffer - blocs par tampon),du nom du paramètre qui permet de l'activer. Dans cette annexe, les termes "BatchBooster" et "traitement BPB" sont donc indifféremment employés.

Batch Booster est une option payante (MI) de GCOS 7 HPS AP et EXMS version V7.Batch Booster est décrit plus en détail dans un manuel qui lui est spécifiquementconsacré.

G.1.1 Mise en oeuvre de Batch Booster

Les paragraphes qui suivent décrivent les différentes manières d'activer Batch Booster.

G.1.1.1 Lancement externe au programme

Batch Booster peut être activé dans une rubrique de description d'activité ou par unutilitaire, comme indiqué ci-dessous.

Ordre JCL ParamètreRubrique de description d'activité

DEFINE BPBUtilitaire

INDEFOUTDEFPRTDEF

BPB


G-2 47 F2 04UF Rev04

G.1.1.2 Lancement au sein d'un programme

En COBOL et en langage C, Batch Booster n'est pas programmable. En GPL, utiliser laprimitive H_FD ou H_DEFINE/H_DCFILE avec le paramètre BPB.

G.1.2 Mode d'exécution du traitement BPB

UFAS-EXTENDED transfère plusieurs CIs depuis ou vers les tampons en une seuleopération d'E/S. Le nombre de CIs transférés dépend de la valeur du paramètre BPB(comprise entre 2 et 255).

UFAS-EXTENDED réduit automatiquement la valeur de BPB de sorte que :

BPB * CISIZE soit inférieur à 64Ko.

G.2 CONDITIONS D'EXECUTION DU TRAITEMENT BPB

Pour que BPB s'exécute correctement, l'environnement de travail doit remplir lesconditions suivantes :

• accès au niveau article ,• valeur du paramètre BPB supérieure à 1,• application en mode BATCH monoprocess,• organisation de fichier SEQUENTIAL ou RELATIVE,• affectation de fichier suivante :

ONEWRITE/SPREADONEWRITE/SPWRITENORMAL/SPREADNORMAL/SPWRITENORMAL/READNORMAL/WRITEou MONITOR/READ avec READLOCK=STAT,

• mode d'ouverture INPUT, OUTPUT, ou APPEND,• mode d'accès SEQUENTIAL,• version CURRENT,• pas de journalisation ,• pas de fonction GAC (General Access Control) .

Lorsque ces conditions ne sont pas remplies, BPB est inopérant ; la valeur affectée àBPB est ignorée et, implicitement, l'exécution s'effectue comme si elle était égale à 1. Engénéral, le process ne s'arrête pas prématurément et aucun message d'erreur ou coderetour n'est émis. En revanche, une valeur de BPB supérieure à 1 avec multi SCB (parexemple, en cas d'accès à des fichiers UFAS sous IQS) provoque l'émission du coderetour CONFLICT.

Batch Booster (Optimiseur d'E/S Traitement par lots)

47 F2 04UF Rev04 G-3

G.3 BPB ET UTILITAIRES DE GESTION DE DONNEES

BPB fonctionne avec les utilitaires de gestion de données travaillant au niveau article ci-après :

COMPARE Sur les deux fichiers d'entrée et le fichierde sortie, à condition que ces fichiers nesoient pas des fichiers relatifs traités enaccès direct.

CREATE Sur le fichier d'entrée ou le fichier de sortie,à condition que ce fichier ne soit pas unfichier relatif traité en accès direct.

PRINT Sur le fichier d'entrée.

FILSAVE Sur le fichier de sortie, à condition que cefichier soit un fichier disque UFAS.

G.3.1 Transfert de fichiers

L'utilitaire de transfert de fichiers admet BPB sur le fichier local uniquement . Parconséquent :

• si le site local est en émission, BPB fonctionne sur le fichier d'entrée,

• si le site local est en réception, BPB fonctionne sur le fichier de sortie.


G-4 47 F2 04UF Rev04

G.3.2 Utilitaires de Tri/Fusion (SORT/MERGE)

G.3.2.1 Tri

L'utilitaire de tri (SORT) faut appel à la méthode d'accès UFAS comme suit.

Tri monoprocess

Les fichiers indexés UFAS, SORT fait toujours appel à la méthode d'accès UFAS (maisUFAS BPB ne s'applique pas dans ce cas).

Pour les fichiers UFAS d'entrée séquentiels et relatifs, SORT fait toujours appel à laméthode d'accès UFAS dans les cas suivants :

• SHARE = FREE, DIR, ONEWRITE ou (SHARE=MONITOR et READLOCK=STAT)

• ou "tous les volumes ne sont pas montés pour le fichier",

• ou TRUNCSSF est spécifié,

• ou il y a concaténation,

• ou REPEAT et CKPTLIM,

• ou DSL contient KEYADDR ou ADDATA ou ADDROUT.

Pour les fichiers UFAS de sortie séquentiels et relatifs, SORT fait toujours appel à laméthode d'accès UFAS dans les cas suivants :

• SHARE différent de NORMAL,• ou "tous les volumes ne sont pas montés pour le fichier",• ou REPEAT et CKPTLIM.

Remarque : Pour SHARE = MONITOR, (READLOCK = STAT) ou (ACCESS =SPREAD ou SPWRITE) sont obligatoires pour INFILE. PourOUTFILE, ACCESS = SPWRITE est obligatoire si SHARE =MONITOR.

Batch Booster (Optimiseur d'E/S Traitement par lots)

47 F2 04UF Rev04 G-5

Tri multiprocess

Les fichiers indexés UFAS, SORT fait toujours appel à la méthode d'accès UFAS (maisUFAS BPB ne s'applique pas dans ce cas).

Pour les fichiers UFAS d'entrée (mode INPUT) séquentiels et relatifs, SORT fait toujoursappel à la méthode d'accès UFAS dans les cas suivants :

SHARE = FREE, DIR, ONEWRITE ou (SHARE=MONITOR et READLOCK=STAT)

• ou "tous les volumes ne sont pas montés pour le fichier",

• ou TRUNCSSF est spécifié,

• ou il y a concaténation,

• ou DSL contient(KEYADDR ou ADDATA ou ADDROUT)et(STARTou HALTou (((INVREC^=CONTINUE) ou (ERROPT^=IGNORE)) et (RECFORM=V))

Pour les fichiers UFAS de sortie séquentiels et relatifs, SORT fait toujours appel à laméthode d'accès UFAS dans les cas suivants :

• SHARE différent de NORMAL,• ou "tous les volumes ne sont pas montés pour le fichier".

Remarques : Pour SHARE = MONITOR, (READLOCK = STAT) ou (ACCESS =SPREAD ou SPWRITE) sont obligatoires pour INFILE. PourOUTFILE, ACCESS = SPWRITE est obligatoire si SHARE =MONITOR.

G.3.2.2 Fusion

L'utilitaire de fusion (MERGE) fait appel à la méthode d'accès UFAS dans les mêmesconditions que SORT (à ceci près que les conditions DSL ne s'appliquent pas).


G-6 47 F2 04UF Rev04

G.4 BPB EN ENVIRONNEMENT GCL

Cette annexe traite principalement de l'emploi de BPB en traitement par lots, donc enenvironnement JCL, mais l'environnement GCL peut également bénéficier de BPB.

En GCL, BPB est utilisable avec la commande EXEC_PG et les commandes d'appel desutilitaires GCOS 7.

Pour plus d'informations, se reporter au manuel Batch Booster.

47 F2 04UF Rev04 i-1

Index

A

ACCESS 5-18Affectation de fichiers 5-5, 5-6ALCn 6-47Appareils

Pool d'~ 5-16APPEND (mode d'ouverture) 2-3APPLY NO-SORTED INDEX ON 4-11Article

de longueur fixe 1-5, 7-5de longueur variable 1-5, 7-6Définition 1-4Descripteur d'~ (RDW) 4-25, 7-6Format d'~ (RECFORM) 7-4Insertion d'~s 4-20Longueur d'~ (RECSIZE) 6-19, 7-4

Articles de longueur fixe 2-6Définition 1-5groupés en blocs 7-5non groupés en blocs 7-5

Articles de longueur variable 2-6Définition 1-5groupés en blocs 7-8non groupés en blocs 7-6

ASCII (code ~) B-16ASGn 5-6

B

BLKSIZE 7-4, 7-9Bloc

de données 1-4de fichier 1-4Descripteur de ~ (BDW) 7-6Longueur de ~ (BLKSIZE) 7-4, 7-9Numéro de ~ (BSN) 7-6Unité d'affectation (BLOCK) 6-3

Bloc de données 1-9BLOCK (unité d'affectation) 6-3Blocking factorVoir facteur de groupage: 6-22

BSN 7-6BUFPOOL 5-28BUILD_FILE 6-39

C

Capacité d'une bande 7-9Cartouche (bande en ~) 7-1CI (intervalle de contrôle)

Compactage 4-21Définition 1-5En-tête de ~ 2-6, 3-7, 4-25Espace libre par ~ 4-19, 6-24Fichier relatif 3-7Fichier séquentiel 2-6Fichier séquentiel indexé 4-25Nb. de ~ par cylindre 6-6Nb. de ~ par piste 6-6Réorganisation incrémentale 4-22Répartition des différents ~ 1-7Unité d'affectation (CI) 6-39

CIFSP 4-19, 6-24CISIZE

Choix de ~ 6-23Valeurs recommandées 6-6

CléDéfinition 4-2

Clé primaireAdjonction d'articles 4-10Définition 4-2

Clé secondaireDéfinition 4-2

CodeASCII B-16EBCDIC B-4

COMFILE 6-46CREATE_CT_FILE 7-11CREATE_FILE 6-44CREATE_MT_FILE 7-11CREATE_TAPE_FILE 7-11CYL (unité d'affectation) 6-3Cylindre

Capacité 6-7Définition 1-10


i-2 47 F2 04UF Rev04

Nombre de CI par ~ 6-6Unité d'affectation (CYL) 6-3

D

DEFn 5-23, 6-49, 7-14Densité d'enregistrement 7-9Descripteur

d'article (RDW) 4-25, 7-6de bloc (BDW) 7-6

Disque FSACapacité 6-7

Disque non-FSACapacité 6-7

DSL (langage ~) 8-7DUPKEY 5-50

E

EBCDIC (code ~) B-6Espace

Fichier relatif 6-19Fichier séquentiel 6-14Fichier séquentiel indexé 6-26inutilisé 2-6, 3-7, 3-8, 4-25libre (CIFSP) 4-19, 6-24

Espace adressesContenu de chaque ~ 4-13Définition 1-7

EXTEND(mode d'ouverture) 2-3, 3-4, 4-5, 4-6

F

Facteur de groupage 6-22FBO 1-9Fichier

Affectation 5-5, 5-6Extension dynamique 5-52, 6-12Extension statique 5-52, 6-56Fragment 1-12, 6-3Intégrité 5-48Journalisation 5-46Labels début de ~ B-7Migration VBO-FBO 8-6multivolume 5-12Paramétrage 6-22Partage 5-18permanent 7-2Protection 5-46, 5-48relatif 3-2Sauvetage (File Salvager) 5-50séquentiel 2-2séquentiel indexé 4-2sur bande 7-1, 7-2

temporaire 7-2Fichier bande

Attributs 7-4Création 7-10

Fichier relatif1ère utilisation d'un ~ 3-6Mode d'accès 3-3Mode d'ouverture 3-3

Fichier séquentiel1ère utilisation d'un ~ 2-4Généralités 2-2Mode d'accès 2-4Mode d'ouverture 2-3

Fichier séquentiel indexé1ère utilisation d'un ~ 4-10Généralités 4-2Mode d'accès 4-6Mode d'ouverture 4-5Paramétrage 6-22Structure 4-13

FLNAV 5-49Format standard GCOS7/ASCII(bande) B-16Fragment (de fichier) 1-12, 6-3

G

Groupe de paramètresALCn (réservation d'espace) 6-47ASGn (affectation de fichiers) 5-6DEFn (définition de fichiers)

5-23, 6-49, 7-14

I

INCRSIZE 5-52, 6-12Index

de niveau inférieur 4-15de niveau supérieur 4-14Définition 4-3dense 4-14primaire 4-16secondaire 4-16

Index primaireStructure 4-16

Index secondaireCréation 4-11Mise à jour 4-12Structure 4-16

Insertion de masse 6-25

J

JCL-->GCL (correspondance) D-1Journal

Index

47 F2 04UF Rev04 i-3

Après 5-47Avant 5-46

K

KEYLOC 6-31KEYSIZE 6-31

L

LabelInformations 5-21

Label (bande) 7-3Début de fichier B-7Début de volume B-6Fin de fichier B-11Types de ~ B-4

LIST_FILE 6-52LIST_FILE_SPACE 6-53LOAD_FILE 8-3

M

MAINTAIN_MIGRATION 8-6Marques réfléchissantes B-5MAXXET 6-3MNMIG 8-6Mode d'accès

direct 3-5, 4-8dynamique 3-6, 4-9séquentiel 2-4, 3-4, 4-6

Mode d'accès et performances 6-22Mode d'ouverture

Fichier relatif 3-3Fichier séquentiel 2-3Fichier séquentiel indexé 4-5

MODIFY_FILE 6-54MODIFY_FILE_SPACE 6-56MOUNT 5-14Multivolume

Fichier ~ bande 5-14Fichier ~ disque 5-14Généralités 5-12Mode d'ouverture d'un fichier ~ 2-4

N

NBBUF 5-23, 5-31NORMAL 5-18

O

ONEWRITE 5-18Optimisation (tuning)

Gestion des tampons 5-40Organisation de fichierVoir fichier: 1-3Organisation relative

Accès direct 3-5Accès dynamique 3-6Accès séquentiel 3-4Généralités 3-2

Organisation séquentielle 2-2Accès séquentiel 2-4

Organisation séquentielle indexée 4-2Accès direct 4-8Accès dynamique 4-9Accès séquentiel 4-6Espace interbloc 7-9

P

Partage (de fichier) 5-18Passage UFAS/UFAS-EXTENDED 8-5Piste

Définition 1-10POOL 5-3, 5-4, 5-16Pool

d'appareils 5-16de tampons 5-28

POOLSIZE 5-26

R

RandomisationAnalyse des fréquences A-6Changement base numération A-5Division par nombre premier A-2Elévation au carré/pliage/extraction A-4

RDW 7-6Règles de recouvrement 5-21Réservation d'espace

Commandes de ~ 6-39Exemples avec BUILD_FILE 6-41Exemples avec CREATE_FILE 6-44

RRN (numéro relatif d'article) 3-2Randomisation A-1

S

SauvetageFichier avec clés secondaires 5-51Fichier sans clés secondaires 5-50

SCIDXNAV 5-49, 5-51


i-4 47 F2 04UF Rev04

SECIDX 6-32SHARE 5-18SIZE 6-11SORT_INDEX 4-11, 5-49, 5-51SPLIT 6-4, 6-11

T

TamponDéfinition 5-24Gestion des ~s 5-24Optimisation 5-40Pool de ~s 5-28

U

UtilitairesNiveau fichier 8-8Niveau volume 8-11

V

VBO 1-10Volume

Bande 7-2de manoeuvre 5-10Début de ~ bande B-6Formats de ~s bande B-4, B-13nommément désigné 5-11Numéro d'immatriculation B-7Numéro d'ordre B-7résidant 5-9

Volume FBOOrganisation 1-9

Volume VBOAdresse sur un ~ 1-11Organisation 1-10

VTOC 5-22

X

XetentVoir fragment: 6-3

Gestion des fichiers et des volumes BULL DPS...

Documents

Transcript of Gestion des fichiers et des volumes BULL DPS...