CRTGSS

La commande CRTGSS (Créer un jeu de symboles graphiques) permet de créer un objet jeu de symboles graphiques à partir d'un fichier physique qui contient des données de jeu de symboles. En fonction du contenu du fichier, cette commande crée un jeu de symboles vectoriels (caractères graphiques de mode 3) ou un jeu de symboles image (caractères graphiques de mode 2).

L'objet jeu de symboles peut être utilisé dans un programme GDDM* ou PGR, ou dans un tableau BGU comme solution de remplacement d'un jeu de symboles graphiques fourni par IBM. Pour plus de détails sur BGU, reportez-vous au manuel BGU User's Guide and Reference, SC09-1408.

Restriction : Pour pouvoir être utilisé avec cette commande, un fichier physique doit comporter des enregistrements dont la longueur est comprise entre 80 et 400 octets ; un fichier source doit contenir entre 92 et 412 octets. Le contenu du fichier doit respecter le format du jeu de symboles.

Paramètres

Jeu de symboles graphiques (GSS)

Indique la bibliothèque et le nom du jeu de symboles graphiques à créer. Si aucun nom de bibliothèque n'est indiqué, ce jeu de symboles est stocké dans la bibliothèque *CURLIB. Le nom d'un jeu de symboles graphiques ne doit pas dépasser huit caractères.

Ce paramètre est obligatoire.

Fichier (FILE)

Indique la bibliothèque et le nom du fichier de données source utilisé pour créer le jeu de symboles.

Ce paramètre est obligatoire.

Les valeurs possibles pour la bibliothèque sont les suivantes :

*CURLIB

Le jeu de symboles graphiques est stocké dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez la bibliothèque dans laquelle sera stocké le jeu de symboles graphiques.

Membre (MBR)

Indique le nom du membre de fichier utilisé pour créer le jeu de symboles.

Les valeurs possibles sont les suivantes :

*GSS

Le nom du membre contenant les données en entrée est identique à celui du jeu de symboles créé.

nom-membre

Indiquez le membre contenant les données en entrée du jeu de symboles.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

Les valeurs possibles sont les suivantes :

*MBRTXT

Le texte provient du membre utilisé pour créer le jeu de symboles.

*BLANK

Aucun texte n'est indiqué.

'description'

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

Les valeurs possibles sont les suivantes :

*LIBCRTAUT

Le système détermine les droits sur l'objet en utilisant la valeur définie dans l'invite Droits pour objets créés (paramètre CRTAUT) de la commande CRTLIB (Créer une bibliothèque), pour la bibliothèque qui contiendra l'objet à créer. Si la valeur indiquée dans l'invite Droits pour objets créés (paramètre CRTAUT) est modifiée, la nouvelle valeur n'affectera aucun des objets existants.

*CHANGE

L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*ALL

L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

*EXCLUDE

L'utilisateur n'a pas accès à l'objet.

nom-liste-autorisation

Indiquez le nom d'une liste d'autorisation. Les droits sur l'objet définis dans la liste sont accordés aux utilisateurs figurant sur celle-ci. La liste d'autorisation doit exister à la création de l'objet.

Exemples

Exemple 1 : création d'un jeu avec le même nom que le fichier source

CRTGSS   GSS(GSSLIB/ADMVARP)  FILE(GSSLIB/ADMVARP)

Cette commande crée un jeu de symboles qui porte le même nom et se trouva dans la même bibliothèque que le fichier source.

Exemple 2 : création d'un jeu à partir d'une bibliothèque différente

CRTGSS   GSS(*CURLIB/VECTOR1)  FILE(GSSLIB/QDATASRC)
         MBR(SCHEM)  AUT(*ALL)  TEXT('Schematic vector symbols')

Cette commande crée un jeu de symboles nommé VECTOR1 dans la bibliothèque QGPL à partir du membre SCHEM du fichier QDATASRC dans la bibliothèque GSSLIB. Le public dispose de droits complets sur le jeu de symboles. Bien que les données du jeu de symboles soient stockées dans le fichier physique source DATASRC, elles ne peuvent pas être éditées ou affichées par le SEU car une partie de leur contenu ne peut pas être affichée.

Messages d'erreur

Messages *ESCAPE

CPF8660

Jeu de symboles &1 non créé dans la bibliothèque &2.