SAUTOSEQ

Description

Spécifie une séquence de caractères, une touche de fonction ou d'interruption ou le stylet pour exécuter une tâche, telle qu'appeler un script de la même manière que le paramètre AUTOSEQ, mais pour une session.

Ce paramètre commun de session s'applique à ces instructions de contrôle : SYSTEM (voir Instruction SYSTEM), PROFILE (voir Instruction PROFILE), USER (voir Instruction USER), TERMINAL (voir Instruction TERMINAL) et APPL (voir Instruction APPL).

Format

SAUTOSEQ escape [A|C ismcommand|E|I|J|N scriptname]
   [PASS REMESC] [NOCURESC]
   [ACTIONKEY aidkey] [COMMANDPRFX Y|N|ON|OFF]
   [PARM Y|N]

Usage et sous-paramètres

escape, qui doit être délimité par un caractère null ou un espace si émis, peut correspondre à une chaîne de 1 à 8 caractères, PF1-24, PA1-3, ATTN, CLEAR ou PEN.

Les sous-paramètres A, I, E et N définissent le type de script à exécuter lorsque escape est entré. Les sous-paramètres C et J permettent d'exécuter d'autres actions lorsque escape est entré. Autres informations sur ces sous-paramètres :

A

AUTOSCRIPT est exécuté pour cette session.

C

Créer le synonyme escape pour la commande IBM Session Manager valide ismcommand. Ce synonyme peut être émis en cours de session. ismcommand peut être n'importe quelle commande IBM Session Manager que peut entrer l'utilisateur dans le menu, sauf les scripts de commandes. Des sélections de session et des transid de session peuvent être entrés ; dans ce cas la session visible bascule vers la session demandée. Si la commande IBM Session Manager a des opérandes, l'ensemble de la commande ismcommand doit être placé entre guillemets, par exemple :

'STOP USER USER1'

Si la commande IBM Session Manager contient une chaîne de caractères normalement entre des guillemets simples, l'ensemble de la commande ismcommand doit être placé entre des guillemets doubles :

"BROADCAST 'Good Morning' ALL"

La commande ismcommand peut contenir des variables qui sont remplacées avant que la commande IBM Session Manager soit appelée :

'QUERY USER &T_USER&'

, où &T_USER& est remplacé par l'identité de l'utilisateur lorsque la commande IBM Session Manager est appelée.

Si la commande ismcommand est rejetée, l'utilisateur reçoit deux messages  : le message 526, puis le message d'erreur résultant.

E

ENDSCRIPT est exécuté pour cette session.

I

Le nom de script fourni avec escape est exécuté.

J

Définit un alias de chaîne de caratères qui représente une instruction pour passer à un applid. Les numéros de session peuvent être saisis ainsi qu'un applid de session. L'alias est défini dans la valeur escape ; il doit comporter entre un et huit caractères et il n'a pas de valeur par défaut. Par exemple, un alias peut être défini comme suit :

SAUTOSEQ .J J

Si un exemple de session a un applid CICSA, l'utilisateur peut accéder à la session en entrant :

.J CICSA

Si l'applid n'est pas valide, le message 527 est émis dans une diffusion IBM Session Manager envoyée à l'utilisateur.

N

Le script spécifié dans le paramètre SAUTOSEQ est exécuté.

PASS

Passe le flux de données complet contenant la séquence SAUTOSEQ escape dans le script. La logique du script peut être utilisée ensuite pour déterminer si la séquence doit être envoyée à l'application. Par exemple, elle peut être utile lorsqu'elle est utilisée avec un script PCTRANSFER piloté par un paramètre d'échappement SAUTOSEQ ayant la valeur IND£FILE. Le flux de données contenant IND£FILE et ses paramètres peut être envoyé ensuite à la session.

REMESC

Indique que la séquence d'échappement doit être supprimée de l'écran de terminal. Si REMESC n'est pas défini, la séquence d'échappement reste affichée lorsque l'utilisateur revient dans la session. Eventuellement, les variables ucrestesc, unrestescrow et unrestesccol, si nécessaire, peuvent être lues par le script et utilisées pour rétablir la séquence supprimée. Pour plus d'informations, voir le manuel Panneaux, script et variables.

Remarques :

  1. Si la fonction MISER (voir le manuel Installation et personnalisation) n'est pas activée sur les sessions où REMESC est utilisé, le retour à la session après un échappement peut afficher des écrans incomplets.
  2. Le mot clé REMESC du sous-paramètre PASS s'applique uniquement aux options SAUTOSEQ qui provoquent l'exécution du script, à savoir que les options A, E, I et N. REMESC ne peut pas être utilisées avec les options C ou J, car elles suppriment automatiquement les séquences d'échappement entrées.

NOCURESC

Si CURESC YES est défini (voir CURESC), le sous-paramètre NOCURESC permet de reconnaître et d'exécuter les séquences SAUTOSEQ dès leur entrée dans la zone d'entrée, quel que soit l'emplacement du curseur. Ceci est particulièrement utile si vous exécutez le script fourni GOPCTRAN qui détecte automatiquement IND£FILE et émet la commande PCTRANSFER.

ACTIONKEY

Permet de définir une touche d'aide aidkey qui appelle le synonyme. aidkey peut être n'importe quelle touche d'aide valide PF1-24. Si ACTIONKEY est défini et que vous appuyez sur la touche Entrée, la séquence SAUTOSEQ escape est appelée. Si ACTIONKEY est utilisé, la séquence SAUTOSEQ escape ne peut pas être un touche de fonction ou d'interruption. Si l'utilisateur tente de définir une séquence ACTIONKEY lorsque la séquence escape est une touche de fonction ou d'interruption, l'erreur 4011 est émise.

Voir aussi CMDACTIONKEY.

COMMANDPRFX

Si COMMANDPRFX Y ou COMMANDPRFX ON est défini dans l'instruction, un caractère de préfixe de commande est activé. Par défaut,COMMANDPRFX a la valeur  N. Si un caractère de préfixe de commande est activé, le caractère de préfixe à utiliser est défini dans le paramètre COMMANDPRFXVAL de l'instruction USER. Par exemple, si un préfixe de commande a été défini dans une instruction USER :

COMMANDPRFXVAL /

et que l'instruction suivante est fournie :

SAUTOSEQ D C DISCONNECT COMMANDPRFX Y ACTIONKEY PF10

, l'utilisaeur peut se déconnecter de la session en entrant /D et en appuyant sur PF10.

Voir aussi COMMANDPRFXVAL.

PARM

Si PARM Y est défini dans l'instruction, IBM Session Manager recherche un paramètre de huit caractères entré après la séquence. Si un paramètre est trouvé, la variable ucsautoparm contiendra la valeur. Le paramètre entré est traité comme faisant partie de la séquence et est ainsi supprimé avec elle. Ce paramètre doit être utilisé uniquement dans les définitions SAUTOSEQ qui appellent des scripts ; la variable est normalement accessible dans ces scripts. Par défaut, PARM a la valeur  N.

Un nombre illimité de paramètres SAUTOSEQ peut être défini pour chaque session. Cependant, comme les scripts sont spécifiques de la session, ils peuvent être exécutés uniquement lorsque la session est active.

Correspondance de séquence d'échappement

Lors de l'évaluation d'une séquenec d'échappement, IBM Session Manager vérifie les séquences configurées par l'utilisateur dans leur ordre d'entrée. La première séquence qui correspond est celle qui sera actionnée.

Il est recommandé de placer les échappements pilotés par une séquence de caractères en premier en les classant par ordre décroissant de longueur de séquence. Cela signifie que les plus longues séquences se trouvent en haut de la liste. Ensuite, les échappements appelés par une fonction ou une touche d'interruption apparaissent à la fin de la liste. Cet ordre est particulièrement important lorsque les échappements sensibles au curseur sont activés (voir CURESC).

Exemple de définition d'échappement :

Ordre

Définition d'échappement

Sortie requise

1

SAUTOSEQ pf5 n aascript

Exécuter le script aascript lorsque l'utilisateur appuie sur la touche PF5.

2

SAUTOSEQ xx n xxscript actionkey pf5

Exécuter le script xxscript lorsque l'utilisateur tape xx et appuie sur la touche PF5.

3

SAUTOSEQ bs n bscript

Exécuter le script bscript lorsque l'utilisateur tape bs et appuie sur la touche Entrée.

4

SAUTOSEQ abs n abscript

Exécuter le script abscript lorsque l'utilisateur tape abs et appuie sur la touche Entrée.

Si les définitions ci-dessus sont entrées dans un système dans lequel les séquences d'échappement sensibles au curseur sont actives, deux problèmes peut apparaître. Si l'utilisateur tape xx et appuie sur la touche PF5, aascript est exécuté à la place de xxscript. Si l'utilisateur tape abs et appuie sur la touche Entrée, bscript est exécuté à la place de abscript.

La solution consiste à changer l'ordre des définitions d'échappement :

Ordre

Définition d'échappement

Sortie requise

1

SAUTOSEQ abs n abscript

Exécuter le script abscript lorsque l'utilisateur tape abs et appuie sur la touche Entrée.

2

SAUTOSEQ bs n bscript

Exécuter le script bscript lorsque l'utilisateur tape bs et appuie sur la touche Entrée.

3

SAUTOSEQ xx n xxscript actionkey pf5

Exécuter le script xxscript lorsque l'utilisateur tape xx et appuie sur la touche PF5.

4

SAUTOSEQ pf5 n aascript

Exécuter le script aascript lorsque l'utilisateur appuie sur la touche PF5.

Voir aussi Mots clés STOPINH et STOP_INHERIT.

Rubrique parent :

Rubriques connexes :