qsubposix - En ligne dans le Cloud

PROGRAMME:

Nom

qsub — soumettre un script

SYNOPSIS

qsub [-a date_time] [-A chaîne_compte] [-c intervalle]
[-C préfixe_directive] [-e nom_chemin] [-h] [−j join_list]
[-k liste_garder] [−m options_mail] [−M liste_de-mails] [-N prénom]
[-o nom_chemin] [−p priorité] [−q destination] [-r y|n]
[−S liste_nom_chemin] [-u liste d'utilisateur] [-v liste_variables] [−V]
[-z] [scénario]

DESCRIPTION

Soumettre un script consiste à créer un travail par lots qui exécute le script. Un script est
soumis par une requête à un serveur batch. Les qsub l'utilitaire est un lot accessible par l'utilisateur
client qui soumet un script.

En cas de réussite, le qsub l'utilitaire doit avoir créé un travail par lots qui
exécuter le script soumis.

L'exposition qsub l'utilitaire doit soumettre un script en envoyant un Queue Emploi Demander vers un serveur batch.

L'exposition qsub L'utilitaire doit placer la valeur des variables d'environnement suivantes dans le
Variable_Liste attribut de la tâche batch : ACCUEIL, LANGUE, NOM DU JOURNAL, PATH, MAIL, SHELLet la bien-aimée Sonate en la majeur TZ.
Le nom de la variable d'environnement doit être le nom actuel précédé de la chaîne
PBS_O_.

Remarque: Si la valeur actuelle du ACCUEIL variable dans l'espace d'environnement du qsub
l'utilité est /aa/bb/cc, puis qsub doit placer PBS_O_HOME=/aa/bb/cc dans le
Variable_Liste attribut du travail par lots.

En plus des variables décrites ci-dessus, le qsub l'utilitaire doit ajouter ce qui suit
variables avec les valeurs indiquées à la liste des variables :

PBS_O_WORKDIR Le chemin absolu du répertoire de travail courant du qsub utilitaire
processus.

PBS_O_HOST Le nom de l'hôte sur lequel le qsub l'utilitaire est en cours d'exécution.

OPTIONS

L'exposition qsub l'utilitaire doit être conforme au volume Base Definitions de POSIX.1‐2008, Blog
12.2, Services Publics Syntaxe Conseils et recommandations.

Les options suivantes doivent être prises en charge par la mise en œuvre :

-a date_time
Définissez l'heure à laquelle un travail par lots devient éligible pour l'exécution.

L'exposition qsub l'utilitaire doit accepter un argument d'option conforme à la syntaxe de
le Paisible opérande du -nous utilitaire.

lampe de table 4-19: Environnement Variable Nos valeurs (Utilitaires)

??
│Variable Nom │ Valeur at qsub Heure │
??
│PBS_O_HOME │ ACCUEIL │
│PBS_O_HOST │ Nom d'hôte du client │
│PBS_O_LANG │ LANGUE │
│PBS_O_LOGNAME │ NOM DU JOURNAL │
│PBS_O_PATH │ PATH │
│PBS_O_MAIL │ MAIL │
│PBS_O_SHELL │ SHELL │
│PBS_O_TZ │ TZ │
│PBS_O_WORKDIR │ Répertoire de travail actuel │
??
Remarque: Le serveur qui lance l'exécution du travail par lots ajoutera d'autres
des variables à l'environnement du travail par lots ; voir Blog 3.2.2.1, Lot
Emploi Internationaux.

L'exposition qsub l'utilitaire fixe le Temps d'exécution attribut du travail par lots au
nombre de secondes depuis l'époque qui équivaut à l'heure locale exprimée
par la valeur de la date_time option-argument. L'Epoque est définie dans la Base
Volume des définitions de POSIX.1‐2008, Blog 3.150, Epoch.

Si la -a l'option n'est pas présentée au qsub service public, le service public doit définir le
Temps d'exécution attribut du traitement par lots à une heure (nombre de secondes depuis le
Epoch) qui est antérieure à l'heure à laquelle l'utilitaire se ferme.

-A chaîne_compte
Définir le compte auquel la consommation des ressources du travail par lots doit être
accusé.

La syntaxe du chaîne_compte option-argument n'est pas spécifié.

L'exposition qsub l'utilitaire fixe le Nom du compte attribut du travail par lots au
valeur de la chaîne_compte argument-option.

Si la -A l'option n'est pas présentée au qsub service public, le service public doit omettre
le Nom du compte à partir des attributs du travail par lots.

-c intervalle
Définissez si le travail par lots doit être contrôlé et, si oui, à quelle fréquence.

L'exposition qsub l'utilitaire doit accepter une valeur pour l'argument-option d'intervalle qui est
l'un des suivants:

n Aucun point de contrôle ne doit être effectué sur le travail par lots (NO_CHECKPOINT).

s Le point de contrôle ne doit être effectué que lorsque le serveur batch est fermé
vers le bas (CHECKPOINT_AT_SHUTDOWN).

c Des points de contrôle périodiques automatiques doivent être effectués au
Minimum_Cpu_Interval attribut de la file d'attente batch, en unités de CPU
minutes (CHECKPOINT_AT_MIN_CPU_INTERVAL).

c=minutes Des points de contrôle périodiques automatiques doivent être effectués chaque minutes of
temps CPU, ou chaque Minimum_Cpu_Interval minutes, selon la valeur la plus élevée.
L'exposition minutes l'argument doit être conforme à la syntaxe des entiers non signés
et doit être supérieur à zéro.

L'exposition qsub l'utilitaire fixe le Point de contrôle attribut du travail par lots au
valeur de la intervalle argument-option.

Si la -c l'option n'est pas présentée au qsub service public, le service public doit définir le
Point de contrôle attribut du traitement par lots au caractère unique 'tu'
(CHECKPOINT_UNSPECIFIED).

-C préfixe_directive
Définir le préfixe qui déclare une directive au qsub utilité au sein de la
scripts.

L'exposition préfixe_directive n'est pas un attribut de travail par lots ; il affecte le comportement de
le qsub utilitaire.

Si la -C l'option est présentée au qsub l'utilité et la valeur de la
préfixe_directive option-argument est la chaîne nulle, l'utilitaire ne doit pas analyser
le fichier de script pour les directives. Si la -C l'option n'est pas présentée au qsub
l'utilité, alors la valeur de la PBS_DPREFIX variable d'environnement est utilisée. Si la
la variable d'environnement n'est pas définie, alors #PBS encodé dans le caractère portable
set est la valeur par défaut.

-e nom_chemin
Définissez le chemin à utiliser pour le flux d'erreurs standard du travail par lots.

L'exposition qsub le service public accepte un nom_chemin option-argument qui peut être précédé
par un élément de nom d'hôte de la forme nom d'hôte:.

Si la nom_chemin option-argument constitue un chemin d'accès absolu, le qsub
l'utilitaire fixe le Chemin_erreur attribut du travail par lots à la valeur du
nom_chemin argument-option.

Si la nom_chemin option-argument constitue un chemin d'accès relatif et aucun hôte
l'élément name est spécifié, le qsub l'utilitaire fixe le Chemin_erreur attribuer
du travail par lots à la valeur du chemin d'accès absolu dérivé en développant le
nom_chemin option-argument relatif au répertoire courant du processus
exécution qsub.

Si la nom_chemin option-argument constitue un chemin d'accès relatif et un nom d'hôte
l'élément est spécifié, le qsub l'utilitaire fixe le Chemin_erreur attribut de la
travail par lots à la valeur de nom_chemin option-argument sans expansion. Les
L'élément de nom d'hôte doit être inclus.

Si la nom_chemin option-argument n'inclut pas d'élément de nom d'hôte, le qsub
l'utilitaire doit préfixer le chemin d'accès avec nom d'hôte:, où nom d'hôte est le nom de
l'hôte sur lequel le qsub l'utilitaire est en cours d'exécution.

Si la -e l'option n'est pas présentée au qsub service public, le service public doit définir le
Chemin_erreur attribut du travail par lots au nom d'hôte et au chemin du
répertoire du processus de soumission et le nom de fichier par défaut.

Le nom de fichier par défaut pour l'erreur standard a le format suivant :

nom du travail.enuméro de séquence

-h Spécifiez qu'une suspension USER est appliquée au travail par lots.

L'exposition qsub le service public fixe la valeur du Hold_Types attribut du lot
job à la valeur USER.

Si la -h l'option n'est pas présentée au qsub service public, le service public doit définir le
Hold_Types attribut du travail par lots à la valeur NO_HOLD.

−j join_list
Définissez les flux du travail par lots à fusionner. Les qsub −j l'option doit
accepter une valeur pour le join_list option-argument qui est une chaîne de
caractères alphanumériques dans le jeu de caractères portable (voir les définitions de base
tome de POSIX.1‐2008, Blog 6.1, Portable Personnage complet »).

L'exposition qsub le service public accepte un join_list option-argument qui se compose d'un
ou plusieurs des personnages 'e' et 'o', ou le caractère unique 'N'.

Tous les autres flux de sortie de travail par lots spécifiés seront fusionnés dans le
flux de sortie représenté par le caractère répertorié en premier dans le join_list option-
argument.

Pour chaque personnage unique dans le join_list option-argument, le qsub utilitaire
doit ajouter une valeur à la Join_Path attribut du travail par lots comme suit, chaque
représentant un flot de travaux par lots différent à joindre :

e L'erreur standard du travail par lots (JOIN_STD_ERROR).

o La sortie standard du job batch (JOIN_STD_OUTPUT).

Un existant Join_Path L'attribut peut être effacé par le type de jointure suivant :

nNO_JOIN

If 'N' est spécifié, aucun fichier n'est joint. Les qsub l'utilitaire doit considérer
c'est une erreur si un type de jointure autre que 'N' est combiné avec le type de jointure 'N'.

Les demandes strictement conformes ne doivent répéter aucun des caractères 'e',
'o', ou 'N' au sein du join_list option-argument. Les qsub l'utilitaire doit permettre
la répétition de caractères, mais n'attribue pas de sens supplémentaire à la
caractères répétés.

Une implémentation peut définir d'autres types de jointure. Le document de conformité d'un
l'implémentation doit décrire tous les flots de travaux par lots supplémentaires, comment ils sont
spécifiés, leur comportement interne et comment ils affectent le comportement du
utilitaire.

Si la −j l'option n'est pas présentée au qsub service public, le service public doit définir le
valeur de la Join_Path attribut du travail par lots à NO_JOIN.

-k liste_garder
Définissez la sortie du travail par lots à conserver sur l'hôte d'exécution.

L'exposition qsub -k option doit accepter une valeur pour le liste_garder option-argument qui
est une chaîne de caractères alphanumériques dans le jeu de caractères portable (voir le
Volume Définitions de base de POSIX.1‐2008, Blog 6.1, Portable Personnage complet »).

L'exposition qsub le service public accepte un liste_garder option-argument qui se compose d'un
ou plusieurs des personnages 'e' et 'o', ou le caractère unique 'N'.

Pour chaque personnage unique dans le liste_garder option-argument, le qsub utilitaire
doit ajouter une valeur à la Garder les fichiers attribut du travail par lots comme suit, chaque
représentant un flot de travaux par lots différent à conserver :

e L'erreur standard du travail par lots (KEEP_STD_ERROR).

o La sortie standard du job batch (KEEP_STD_OUTPUT).

Si les deux 'e' et 'o' sont spécifiés, les deux fichiers sont conservés. Un existant
Garder les fichiers L'attribut peut être effacé par le type de conservation suivant :

n NON_GARDER

If 'N' est spécifié, aucun fichier n'est conservé. Les qsub l'utilitaire doit considérer
c'est une erreur s'il y en a un autre type que 'N' est combiné avec le type de garde 'N'.

Les demandes strictement conformes ne doivent répéter aucun des caractères 'e',
'o', ou 'N' au sein du liste_garder option-argument. Les qsub l'utilitaire doit permettre
la répétition de caractères, mais n'attribue pas de sens supplémentaire à la
caractères répétés.

Une implémentation peut définir d'autres types de conservation. Le document de conformité d'un
la mise en œuvre doit décrire tous les types de conservation supplémentaires, la manière dont ils sont spécifiés,
leur comportement interne et comment ils affectent le comportement de l'utilitaire. Si la
-k l'option n'est pas présentée au qsub service public, le service public doit définir le
Garder les fichiers attribut du travail par lots à la valeur NO_KEEP.

−m options_mail
Définir les points de l'exécution du travail batch auxquels le serveur batch
qui gère le travail par lots doit envoyer un e-mail concernant un changement dans l'état du
travail par lots.

L'exposition qsub −m option doit accepter une valeur pour le options_mail argument-option
qui est une chaîne de caractères alphanumériques dans le jeu de caractères portable (voir
le volume Définitions de base de POSIX.1‐2008, Blog 6.1, Portable Personnage
complet »).

L'exposition qsub le service public doit accepter une valeur pour le options_mail option-argument qui
est une chaîne d'un ou plusieurs des caractères 'e', 'b'et la bien-aimée Sonate en la majeur 'une', ou le célibataire
caractère 'N'.

Pour chaque personnage unique dans le options_mail option-argument, le qsub utilitaire
doit ajouter une valeur à la Utilisateurs_Mail attribut du travail par lots comme suit, chaque
représentant un moment différent au cours de la vie d'un travail par lots auquel envoyer
email:

et MAIL_AT_EXIT

b MAIL_AT_BEGINNING

un MAIL_AT_ABORT

Si l'un de ces caractères est dupliqué dans le options_mail argument d'option,
les doublons doivent être ignorés.

Un existant Mail_Points L'attribut peut être effacé par le type de courrier suivant :

n AUCUN_MAIL

If 'N' est spécifié, le courrier n'est pas envoyé. Les qsub l'utilitaire doit le considérer
une erreur si un type de courrier autre que 'N' est combiné avec le type de courrier 'N'.

Les demandes strictement conformes ne doivent répéter aucun des caractères 'e',
'b', 'une', ou 'N' au sein du options_mail argument-option.

L'exposition qsub L'utilitaire doit permettre la répétition de caractères, mais n'attribue pas
signification supplémentaire aux caractères répétés. Une implémentation peut définir
d'autres types de courrier. Le document de conformité d'une implémentation doit décrire
tout type de courrier supplémentaire, la façon dont ils sont spécifiés, leur comportement interne et
comment ils affectent le comportement de l'utilitaire.

Si la −m l'option n'est pas présentée au qsub service public, le service public doit définir le
Mail_Points attribuer à la valeur MAIL_AT_ABORT.

−M liste_de-mails
Définir la liste des utilisateurs auxquels un serveur batch qui exécute le batch job
doit envoyer un courrier, si le serveur envoie un courrier concernant le travail par lots.

La syntaxe du liste_de-mails option-argument n'est pas spécifié.

Si la mise en œuvre de la qsub l'utilitaire utilise un service de noms pour localiser les utilisateurs,
l'utilitaire doit accepter la syntaxe utilisée par le service de noms.

Si la mise en œuvre de la qsub l'utilitaire n'utilise pas de service de noms pour localiser
utilisateurs, l'implémentation doit accepter la syntaxe suivante pour les noms d'utilisateur :

adresse mail[,,adresse mail,,...]

L'interprétation de adresse mail est défini par la mise en œuvre.

L'exposition qsub l'utilitaire fixe le Utilisateurs_Mail attribut du travail par lots au
valeur de la liste_de-mails argument-option.

Si la −M l'option n'est pas présentée au qsub service public, le service public doit placer
uniquement le nom d'utilisateur et le nom d'hôte du processus en cours dans le Utilisateurs_Mail
attribut du travail par lots.

-N prénom Définissez le nom du travail par lots.

L'exposition qsub -N option doit accepter une valeur pour le prénom option-argument qui est un
chaîne de 15 caractères alphanumériques maximum dans le jeu de caractères portable (voir
le volume Définitions de base de POSIX.1‐2008, Blog 6.1, Portable Personnage
complet ») où le premier caractère est alphabétique.

L'exposition qsub le service public fixe la valeur du Nom du travail attribut du travail par lots
à la valeur de la prénom argument-option.

Si la -N l'option n'est pas présentée au qsub service public, le service public doit définir le
Nom du travail attribut du travail par lots au nom du scénario argument de
dont la spécification de répertoire, le cas échéant, a été supprimée.

Si la -N l'option n'est pas présentée au qsub utilitaire, et le script est lu
à partir de l'entrée standard, le service public doit définir le Nom du travail attribut du lot
tâche à la valeur STDIN.

-o nom_chemin
Définissez le chemin de la sortie standard du travail par lots.

L'exposition qsub le service public accepte un nom_chemin option-argument conforme au
syntaxe du nom_chemin élément défini dans le volume Interfaces système de
POSIX.1‐2008, qui peut être précédé d'un élément de nom d'hôte de la forme
nom d'hôte:.

Si la nom_chemin option-argument constitue un chemin d'accès absolu, le qsub
l'utilitaire fixe le Chemin_de-sortie attribut du travail par lots à la valeur du
nom_chemin option-argument sans expansion.

Si la nom_chemin option-argument constitue un chemin d'accès relatif et aucun hôte
l'élément name est spécifié, le qsub l'utilitaire fixe le Chemin_de-sortie attribuer
du travail par lots au chemin d'accès dérivé en développant la valeur du nom_chemin
option-argument relatif au répertoire courant du processus exécutant le
qsub.

Si la nom_chemin option-argument constitue un chemin d'accès relatif et un nom d'hôte
l'élément est spécifié, le qsub l'utilitaire fixe le Chemin_de-sortie attribut de
le travail par lots à la valeur du nom_chemin option-argument sans expansion.

Si la nom_chemin option-argument ne spécifie pas d'élément de nom d'hôte, le qsub
l'utilitaire doit préfixer le chemin d'accès avec nom d'hôte:, où nom d'hôte est le nom de
l'hôte sur lequel le qsub l'utilitaire est en cours d'exécution.

Si la -o l'option n'est pas présentée au qsub service public, le service public doit définir le
Chemin_de-sortie attribut du travail par lots au nom d'hôte et au chemin du
répertoire du processus de soumission et le nom de fichier par défaut.

Le nom de fichier par défaut pour la sortie standard a le format suivant :

nom du travail.onuméro de séquence

−p priorité
Définir la priorité que la tâche par lots doit avoir par rapport aux autres tâches par lots détenues
par le serveur batch.

L'exposition qsub l'utilitaire fixe le Priorité attribut du travail par lots à la valeur
du système priorité argument-option.

Si la −p l'option n'est pas présentée au qsub l'utilité, la valeur de la Priorité
l'attribut est défini par l'implémentation.

L'exposition qsub le service public doit accepter une valeur pour le priorité option-argument qui
est conforme à la syntaxe des entiers décimaux signés, et qui n'est pas inférieur à
−1024 et pas plus de 1023.

−q destination
Définissez la destination du travail par lots.

La destination n'est pas un attribut de travail par lots ; il détermine le serveur batch,
et éventuellement la file d'attente batch, à laquelle le qsub l'utilitaire met en file d'attente le lot
d'emplois.

L'exposition qsub L'utilitaire soumet le script au serveur batch nommé par le
destination option-argument ou le serveur qui possède la file d'attente batch nommé dans le
destination argument-option.

L'exposition qsub l'utilitaire doit accepter un argument d'option pour le −q option conforme
à la syntaxe d'une destination (voir Blog 3.3.2, Destination).

Si la −q l'option n'est pas présentée au qsub utilitaire, le qsub l'utilitaire doit
soumettre le travail par lots à la destination par défaut. Le mécanisme de détermination
la destination par défaut est définie par l'implémentation.

-r y|n Définissez si le travail par lots est réexécutable.

Si la valeur de l'argument option est y, la qsub l'utilitaire fixe le
Réutilisable attribut du travail par lots à TRUE.

Si la valeur de l'argument option est n, la qsub l'utilitaire fixe le
Réutilisable attribut du travail par lots sur FALSE.

Si la -r l'option n'est pas présentée au qsub service public, le service public doit définir le
Réutilisable attribut du travail par lots à TRUE.

−S liste_nom_chemin
Définissez le chemin d'accès au shell sous lequel le travail par lots doit s'exécuter.

L'exposition qsub le service public accepte un liste_nom_chemin option-argument conforme à
la syntaxe suivante :

chemin d'accès[@hôte][,,chemin d'accès[@hôte],,...]

L'exposition qsub L'utilitaire n'autorise qu'un seul chemin pour un nom d'hôte donné. Les qsub
L'utilitaire ne doit autoriser qu'un seul chemin d'accès auquel il manque un nom d'hôte correspondant.

L'exposition qsub service public doit ajouter une valeur à la Liste_Chemin_Shell attribut du lot
travail pour chaque entrée dans le liste_nom_chemin argument-option.

Si la −S l'option n'est pas présentée au qsub service public, le service public doit définir le
Liste_Chemin_Shell attribut du travail par lots à la chaîne nulle.

Le document de conformité d'une implémentation doit décrire le mécanisme utilisé
pour définir le shell par défaut et déterminer la valeur actuelle du shell par défaut.
Une implémentation doit fournir un moyen pour l'installation de définir la valeur par défaut
shell au shell de connexion de l'utilisateur sous lequel le travail par lots doit s'exécuter.
See Blog 3.3.3, Multiple Mot-clé-valeur Paires pour un moyen d'éliminer
mot-clé=Plus-value (Et Plus-value@mot-clé) paires et autres règles générales pour list-
attributs de travail par lots orientés.

-u liste d'utilisateur
Définissez le nom d'utilisateur sous lequel le travail par lots doit s'exécuter.

L'exposition qsub le service public accepte un liste d'utilisateur option-argument conforme au
syntaxe suivante :

Nom d'utilisateur[@hôte][,,Nom d'utilisateur[@hôte],,...]

L'exposition qsub l'utilitaire n'acceptera qu'un seul nom d'utilisateur auquel il manque un
nom d'hôte. Les qsub L'utilitaire n'acceptera qu'un seul nom d'utilisateur par hôte nommé.

L'exposition qsub service public doit ajouter une valeur à la Liste d'utilisateur attribut du travail par lots
pour chaque entrée dans le liste d'utilisateur argument-option.

Si la -u l'option n'est pas présentée au qsub service public, le service public doit définir le
Liste d'utilisateur attribut du travail par lots au nom d'utilisateur à partir duquel l'utilitaire est
exécution. Voir Blog 3.3.3, Multiple Mot-clé-valeur Paires pour un moyen de
enlever mot-clé=Plus-value (Et Plus-value@mot-clé) paires et autres règles générales pour
attributs de tâche par lots orientés liste.

-v liste_variables
Ajouter à la liste des variables qui sont exportées vers le chef de session du
travail par lots.

A liste_variables est un ensemble de chaînes de la formevariable> ou
<variable=Plus-value>, délimité par personnages.

Si la -v l'option est présentée au qsub service public, le service public doit également ajouter,
à l'environnement Variable_Liste attribut du travail par lots, chaque variable
nommé dans l'environnement liste_variables option-argument et, éventuellement, valeurs
des variables spécifiées.

Si aucune valeur n'est fournie sur la ligne de commande, le qsub l'utilitaire fixe le
valeur de chaque variable dans l'environnement Variable_Liste attribut du lot
job à la valeur de la variable d'environnement correspondante pour le processus dans
lequel l'utilitaire exécute ; voir lampe de table 4-19, Environnement Variable Nos valeurs
(Utilitaires).

Une application conforme ne doit pas répéter une variable dans l'environnement
liste_variables argument-option.

L'exposition qsub l'utilitaire ne doit pas répéter une variable dans l'environnement Variable_Liste
attribut du travail par lots. Voir Blog 3.3.3, Multiple Mot-clé-valeur Paires pour
un moyen de supprimer mot-clé=Plus-value (Et Plus-value@mot-clé) paires et autres général
règles pour les attributs de travail par lots orientés liste.

−V Spécifiez que toutes les variables d'environnement du processus sont exportées vers le
contexte de la tâche par lots.

L'exposition qsub l'utilitaire doit placer chaque variable d'environnement dans le processus dans lequel
l'utilitaire s'exécute dans la liste et doit définir la valeur de chaque variable dans
l'attribut à la valeur de cette variable dans le processus.

-z Spécifiez que l'utilitaire n'écrit pas le lot identifiant_travail de la création
travail par lots à la sortie standard.

Si la -z l'option est présentée au qsub utilitaire, l'utilitaire ne doit pas écrire
le lot identifiant_travail du travail par lots créé à la sortie standard.

Si la -z l'option n'est pas présentée au qsub utilitaire, l'utilitaire doit écrire
l'identifiant de la tâche batch créée à la sortie standard.

OPÉRANDES

L'exposition qsub le service public accepte un scénario opérande qui indique le chemin d'accès au script de
le travail par lots.

Si la scénario l'opérande n'est pas présenté au qsub utilitaire, ou si l'opérande est le
chaîne à un caractère '−', l'utilitaire doit lire le script à partir de l'entrée standard.

Si le script représente un chemin partiel, le qsub l'utilitaire doit étendre le chemin relatif
dans le répertoire courant du processus exécutant l'utilitaire.

STDIN

L'exposition qsub L'utilitaire lit le script du travail par lots à partir de l'entrée standard si le script
l'opérande est omis ou est le caractère unique '−'.

CONTRIBUTION DES DOSSIERS

En plus de lier le dossier indiqué par le scénario opérande au travail par lots, le qsub
L'utilitaire lit le fichier de script et agit sur les directives du script.

ENVIRONNEMENT VARIABLES

Les variables d'environnement suivantes doivent affecter l'exécution de qsub:

LANGUE Fournissez une valeur par défaut pour les variables d'internationalisation qui ne sont pas définies ou
nul. (Voir le volume Définitions de base de POSIX.1‐2008, Blog 8.2,
Internationalisation Variables la préséance des variables d'internationalisation
utilisé pour déterminer les valeurs des catégories de paramètres régionaux.)

LC_TOUS S'il est défini sur une valeur de chaîne non vide, remplace les valeurs de tous les autres
variables d'internationalisation.

LC_CTYPE Déterminer la localisation pour l'interprétation des séquences d'octets de données de texte
sous forme de caractères (par exemple, des caractères à un octet par opposition aux caractères à plusieurs octets dans
arguments).

LC_MESSAGES
Déterminez les paramètres régionaux qui doivent être utilisés pour affecter le format et le contenu de
messages de diagnostic écrits dans l'erreur standard.

NOM DU JOURNAL Déterminez le nom de connexion de l'utilisateur.

PBS_DPREFIX
Déterminez le préfixe par défaut des directives dans le script.

SHELL Déterminer le chemin d'accès de l'interpréteur de langage de commande préféré du
utilisateur.

TZ Déterminer le fuseau horaire utilisé pour interpréter le date-heure option-argument. Si TZ is
unset ou null, un fuseau horaire par défaut non spécifié doit être utilisé.

ASYNCHRONE ÉVÈNEMENTS

Une fois créé, un travail par lots existe jusqu'à ce qu'il se termine, s'interrompe ou soit supprimé.

Après la création d'un travail par lots par le qsub utilitaire, les serveurs batch peuvent router, exécuter,
modifier ou supprimer le travail par lots.

SORTIE STD

L'exposition qsub l'utilitaire écrit le lot identifiant_travail affecté au travail par lots à la norme
sortie, à moins que le -z est spécifiée.

STDERR

L'erreur standard ne doit être utilisée que pour les messages de diagnostic.

SORTIE DES DOSSIERS

Aucun.

ÉLARGI DESCRIPTION

scénario Préservation
L'exposition qsub L'utilitaire doit mettre le script à la disposition du serveur exécutant le travail par lots dans
de telle sorte que le serveur exécute le script tel qu'il existe au moment de la soumission.

L'exposition qsub l'utilitaire peut envoyer une copie du script au serveur avec le Queue Emploi Demander or
stocker une copie temporaire du script dans un emplacement spécifié sur le serveur.

Option Spécifications
Un script peut contenir des directives au qsub utilitaire.

L'exposition qsub l'utilitaire doit analyser les lignes du script à la recherche de directives, en sautant les lignes vides,
jusqu'à la première ligne commençant par une chaîne autre que la chaîne directive ; si
les directives se produisent sur les lignes suivantes, l'utilitaire doit ignorer ces directives.

Les lignes sont séparées par un . Si la première ligne du script commence par "# !" ou
(':'), puis il est ignoré. Les qsub l'utilitaire doit traiter une ligne dans le script comme
une directive si et seulement si la chaîne de caractères du premier espace non blanc
caractère sur la ligne jusqu'au premier ou en ligne correspond à la directive
préfixe. Si une ligne du script contient une directive et les derniers caractères de la ligne
sommes et , alors la ligne suivante doit être interprétée comme une continuation
de cette directive.

L'exposition qsub l'utilitaire doit traiter les options et les arguments d'option contenus dans la directive
ligne de préfixe utilisant la même syntaxe que si les options étaient saisies sur le qsub utilitaire.

L'exposition qsub l'utilitaire continuera à traiter une ligne de préfixe de directive jusqu'à ce qu'une
est rencontré. Une implémentation peut ignorer les lignes qui, selon la syntaxe du
shell qui interprétera le script, sont des commentaires. Une mise en œuvre doit décrire en
le document de conformité le format de tout commentaire de shell qu'il reconnaîtra.

Si une option est présente à la fois dans une directive et dans les arguments du qsub utilitaire, le
l'utilitaire doit ignorer l'option et l'argument d'option correspondant, le cas échéant, dans le
Directive.

Si une option présente dans la directive n'est pas présente dans les arguments de la qsub
utilitaire, l'utilitaire doit traiter l'option et l'argument d'option, le cas échéant.

Par ordre de préférence, les qsub le service public doit sélectionner le préfixe de la directive dans l'un des
sources suivantes :

* Si la -C l'option est présentée au service public, la valeur de la préfixe_directive
argument-option

* Si la variable d'environnement PBS_DPREFIX est définie, la valeur de cette variable

* La chaîne de quatre caractères "#PBS" encodé dans le jeu de caractères portable

Si la -C L'option est présente dans le fichier de script, elle doit être ignorée.

EXIT STATUT

Les valeurs de sortie suivantes doivent être renvoyées :

0 Achèvement réussi.

>0 Une erreur s'est produite.

CONSÉQUENCES OF LES ERREURS

Par défaut.

L'exposition Abonnement les sections sommes-nous informatif.

INSCRIPTION UTILISATION

Aucun.

EXEMPLES

Aucun.

RAISONNEMENT

L'exposition qsub L'utilitaire permet aux utilisateurs de créer un travail par lots qui traitera le script spécifié
comme opérande de l'utilitaire.

Les choix du qsub permet aux utilisateurs de contrôler de nombreux aspects de la file d'attente et
l'exécution d'un travail par lots.

L'exposition -a L'option permet aux utilisateurs de désigner le temps après lequel le travail par lots deviendra
éligible pour courir. En spécifiant une heure d'exécution, les utilisateurs peuvent profiter des ressources à
heures creuses, synchroniser les tâches avec des événements chronologiquement prévisibles et peut-être prendre
avantage d'une tarification hors pointe du temps de calcul. Pour ces raisons et d'autres, un moment
est une pratique existante de la part de presque tous les systèmes de traitement par lots, y compris NQS.

L'exposition -A L'option permet aux utilisateurs de spécifier le compte qui sera facturé pour le travail par lots.
La prise en charge du compte n'est pas obligatoire pour les serveurs batch conformes.

L'exposition -C L'option permet aux utilisateurs de prescrire le préfixe des directives dans le fichier de script.
Le préfixe par défaut "#PBS" peut être inapproprié si le script est interprété avec un
shell alternatif, comme spécifié par le −S option.

L'exposition -c L'option permet aux utilisateurs d'établir l'intervalle de point de contrôle pour leurs travaux. UNE
système de point de contrôle, qui n'est pas défini par ce volume de POSIX.1‐2008, permet la récupération
d'un travail par lots au point de contrôle le plus récent en cas de plantage. Le point de contrôle est
généralement utilisé pour les travaux qui consomment du temps de calcul coûteux ou doivent répondre à un
calendrier. Les utilisateurs devraient être autorisés à faire le compromis entre les frais généraux de
les points de contrôle et le risque pour l'achèvement en temps voulu du travail par lots ; par conséquent, ce
volume de POSIX.1‐2008 fournit l'option d'intervalle de point de contrôle. Soutien
le point de contrôle est facultatif pour les serveurs batch.

L'exposition -e L'option permet aux utilisateurs de rediriger les flux d'erreurs standard de leurs travaux vers un
chemin par défaut. Par exemple, si le script soumis produit généralement beaucoup de
sortie d'erreur inutile, un utilisateur peut rediriger la sortie d'erreur standard vers le périphérique null.
Ou, si le système de fichiers contenant l'emplacement par défaut (le répertoire personnel de l'utilisateur) a
trop peu d'espace libre, l'utilisateur peut rediriger le flux d'erreurs standard vers un fichier dans
un autre système de fichiers.

L'exposition -h L'option permet aux utilisateurs de créer un travail par lots qui est suspendu jusqu'à ce qu'il soit explicitement publié.
La possibilité de créer un travail suspendu est utile lorsqu'un événement externe doit se terminer avant
le travail par lots peut s'exécuter. Par exemple, l'utilisateur peut soumettre un travail suspendu et le libérer
lorsque la charge du système a chuté.

L'exposition −j L'option permet aux utilisateurs de fusionner l'erreur standard d'un travail par lots dans son standard
flux de sortie, qui a l'avantage de montrer la relation séquentielle entre
messages de sortie et d'erreur.

L'exposition −m L'option permet aux utilisateurs de désigner ces points dans l'exécution d'un travail par lots à
quel courrier sera envoyé à l'utilisateur soumettant, ou au(x) compte(s) indiqué(s) par le −M
option. En demandant une notification par courrier à des points d'intérêt dans la vie d'un emploi, le
l'utilisateur soumettant, ou d'autres utilisateurs désignés, peuvent suivre la progression d'un travail par lots.

L'exposition -N L'option permet aux utilisateurs d'associer un nom au travail par lots. Le nom du travail en aucun cas
affecte le traitement du travail par lots, mais sert plutôt de poignée mnémonique pour les utilisateurs.
Par exemple, le nom de la tâche par lots peut aider l'utilisateur à faire la distinction entre plusieurs tâches répertoriées
par le qstat utilitaire.

L'exposition -o L'option permet aux utilisateurs de rediriger le flux de sortie standard. Un utilisateur peut, par
exemple, souhaitez rediriger vers le périphérique null le flux de sortie standard d'un travail qui
produit une production abondante mais superflue.

L'exposition −P L'option permet aux utilisateurs de désigner la priorité relative d'un travail par lots pour la sélection
d'une file d'attente.

L'exposition −q L'option permet aux utilisateurs de spécifier une file d'attente initiale pour le travail par lots. Si l'utilisateur
spécifie une file d'attente de routage, le serveur batch achemine le travail par lots vers une autre file d'attente pour
l'exécution ou le routage ultérieur. Si l'utilisateur spécifie une file d'attente sans routage, le serveur batch
de la file d'attente exécute finalement le travail par lots.

L'exposition -r L'option permet aux utilisateurs de contrôler si le travail soumis sera réexécuté si le
le contrôle du nœud de traitement par lots échoue pendant l'exécution du travail par lots. Les -r option de même
permet aux utilisateurs d'indiquer si le travail par lots est éligible pour être réexécuté par le
qréexécuter utilitaire. Certaines tâches ne peuvent pas être réexécutées correctement en raison de modifications apportées dans le
l'état des bases de données ou d'autres aspects de leur environnement. Ce volume de POSIX.1‐2008
spécifie que la valeur par défaut, si le -r option n'est pas présentée à l'utilitaire, sera que
la tâche par lots ne peut pas être réexécutée, car le résultat de la réexécution d'une tâche non réexécutable peut être
catastrophique.

L'exposition −S L'option permet aux utilisateurs de spécifier le programme (généralement un shell) qui sera appelé
pour traiter le script du travail par lots. Cette option a été modifiée pour permettre une liste de
noms de shell et emplacements associés à différents hôtes.

L'exposition -u L'option est utile lorsque l'utilisateur soumettant est autorisé à utiliser plus d'un
compte sur un hôte donné, auquel cas le -u L'option permet à l'utilisateur de choisir parmi
ces comptes. L'argument-option est une liste de paires utilisateur-hôte, de sorte que la soumission
l'utilisateur peut fournir différents identifiants d'utilisateur pour différents nœuds dans le cas où le travail par lots
est routé. Les -u L'option offre une grande flexibilité pour s'adapter à des sites complexes
structures de compte. Utilisateurs qui ont le même identifiant utilisateur sur tous les hébergeurs qu'ils sont
autorisé à utiliser n'aura pas besoin d'utiliser le -u option.

L'exposition −V L'option permet aux utilisateurs d'exporter toutes leurs variables d'environnement actuelles, à partir de la
moment où le travail par lots est soumis, au contexte des processus du travail par lots.

L'exposition -v L'option permet aux utilisateurs d'exporter des variables d'environnement spécifiques à partir de leur
processus aux processus du travail par lots.

L'exposition -z L'option permet aux utilisateurs de supprimer l'écriture de l'identifiant du travail par lots en standard
sortir. Les -z L'option est une pratique existante du NQS qui a été normalisée.

Historiquement, le qsub l'utilitaire a rempli la fonction de soumission de travaux par lots dans le NQS
système, la pratique existante sur laquelle il se fonde. Certains changements et ajouts ont été
fait à la qsub utilitaire dans ce volume de POSIX.1‐2008, vis-à-vis NQS, en raison de la
un bassin d'expérience croissant avec les systèmes de lots distribués.

L'ensemble des caractéristiques du qsub l'utilitaire tel que défini dans ce volume de POSIX.1‐2008 apparaît
d'intégrer toutes les pratiques courantes existantes sur les plateformes potentiellement conformes.

FUTUR DIRECTIONS

L'exposition qsub L'utilitaire peut être supprimé dans une future version.

Utilisez qsubposix en ligne en utilisant les services onworks.net