RTVPWRSCDE

Extraire poste planning ST/HT

En bref

La commande RTVPWRSCDE (Extraire un poste planning de mise sous/hors tension) permet d'extraire la valeur d'un poste planning de mise sous/hors tension en vue de son utilisation dans un programme CL ou REXX.

RTVPWRSCDE se lit RTV (Extraire (récupérer)) + PWRSCDE. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RTVPWRSCDE

Paramètres

DAY Jour
PWRONTIME Variable pour PWRONTIME (6)
PWROFFTIME Variable pour PWROFFTIME (6)
DAYDESC Variable pour DAYDESC (38)
MSGITV Variable pour MSGITV (2 0)

Astuce : dans une session 5250, tapez RTVPWRSCDE puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Compiled CL program or interpreted REXX (*BPGM *IPGM *BREXX *IREXX)
Compatible multitâche : Non

Restrictions :

Pour utiliser cette commande, vous devez disposer du droit d'utilisation (*USE) sur la commande DSPPWRSCD (Afficher planning mise ST/HT).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DAY	Jour	Date, TODAY, SUN, MON, TUE, WED, THU, FRI, SAT	Facultatif, positionnel 1
PWRONTIME	Variable pour PWRONTIME (6)	Valeur caractère	Facultatif
PWROFFTIME	Variable pour PWROFFTIME (6)	Valeur caractère	Facultatif
DAYDESC	Variable pour DAYDESC (38)	Valeur caractère	Facultatif
MSGITV	Variable pour MSGITV (2 0)	Nombre décimal	Facultatif

Jour (DAY)

Indique la date d'extraction d'un poste planning de mise sous/hors tension.

*TODAY: Le poste planning correspondant à la date du jour est extrait.
*SUN: Le poste planning correspondant à dimanche est extrait.
*MON: Le poste planning correspondant à lundi est extrait.
*TUE: Le poste planning correspondant à mardi est extrait.
*WED: Le poste planning correspondant à mercredi est extrait.
*THU: Le poste planning correspondant à jeudi est extrait.
*FRI: Le poste planning correspondant à vendredi est extrait.
*SAT: Le poste planning correspondant à samedi est extrait.
date: Indiquez la date d'extraction d'un poste planning. Le format de cette date doit être identique à celui précisé par les attributs du travail.

Variable pour PWRONTIME (6) (PWRONTIME)

Indique le nom de la variable CL (6 caractères au moins) qui reçoit l'heure de mise sous tension. La valeur spéciale *NONE ou l'heure exprimée dans le format hhmmss (où hh = heures, mm = minutes et ss = secondes) est renvoyée.

Variable pour PWROFFTIME (6) (PWROFFTIME)

Indique le nom de la variable CL (6 caractères au moins) qui reçoit l'heure de mise hors tension. La valeur spéciale *NONE ou l'heure exprimée dans le format hhmmss (où hh = heures, mm = minutes et ss = secondes) est renvoyée.

Variable pour DAYDESC (38) (DAYDESC)

Indique le nom de la variable CL utilisée pour la valeur du jour. La description du jour est une explication du schéma de mise sous/hors tension pour cette date. La variable mentionnée doit comporter au minimum 38 caractères.

Variable pour MSGITV (2 0) (MSGITV)

Indique le nom de la variable CL (2 caractères au minimum) qui reçoit la valeur de l'intervalle message. Cet intervalle correspond au délai de mise hors tension après l'envoi d'un message d'avertissement à tous les postes de travail.

Exemples

Exemple 1 : extraction du poste du planning du jour

DCL   VAR(&ONTIME)  TYPE(*CHAR)  LEN(6)
DCL   VAR(&OFFTIME)  TYPE(*CHAR)  LEN(6)
RTVPWRSCDE   DAY(*TODAY)  PWRONTIME(&ONTIME) +
             PWROFFTIME(&OFFTIME)

Cette commande extrait les heures de mise sous tension et hors tension du jour en cours.

Exemple 2 : extraction du poste du planning de mardi

DCL   VAR(&ONTIME)  TYPE(*CHAR)  LEN(6)
DCL   VAR(&OFFTIME)  TYPE(*CHAR)  LEN(6)
RTVPWRSCDE   DAY(*TUE)  PWRONTIME(&ONTIME)  PWROFFTIME(&OFFTIME)

Cette commande extrait les heures de mise sous tension et hors tension du mardi.

Messages d'erreur

Messages *ESCAPE

CPF1E2B: Options de mise sous/hors tension et de ménage non trouvées.
CPF1E23: Planning de mise ST/HT ou options de ménage utilisés par autre utilisateur.
CPF1E99: Erreur non prévue.
CPF2105: Objet &1 de &2 type *&3 non trouvé.
CPF9808: Allocation impossible pour une ou plusieurs bibliothèques de la liste.