Χρήση του Βοηθήματος καταλόγου

Το Βοήθημα καταλόγου είναι μια εφαρμογή Java που μπορείτε να χρησιμοποιήσετε για τη διαχείριση ρυθμίσεων χρηστών, ομάδων ή συνεδριών που έχουν αποθηκευτεί είτε στο Host On-Demand είτε σε έναν εξυπηρετητή LDAP. Το Βοήθημα καταλόγου σάς επιτρέπει να προσθέσετε ή να ενημερώσετε μεγάλους αριθμούς χρηστών, ομάδων ή συνεδριών από ένα αρχείο ASCII, αντί να τους προσθέσετε χωριστά από το παράθυρο του Βοηθήματος διαχείρισης. Για παράδειγμα, μπορείτε να χρησιμοποιήσετε το Βοήθημα καταλόγου για να κάνετε τα εξής:

Να προσθέσετε, να ενημερώσετε και να διαγράψετε χρήστες
Να προσθέσετε, να ενημερώσετε και να διαγράψετε χρήστες από ομάδες
Να προσθέσετε και να διαγράψετε συνεδρίες από χρήστες ή από ομάδες
Να δημιουργήσετε λίστες με υπάρχοντες χρήστες και ομάδες (σε αρχεία εξόδου)
Να δημιουργήσετε λίστες με υπάρχοντες χρήστες και ομάδες (σε αρχεία εξόδου) ως προϊόντα μοναδικών αναζητήσεων, με τη χρήση κριτηρίων με ευέλικτες επιλογές υποκατάστασης
Να εκτελέσετε ενέργειες με τα αποτελέσματα μιας αναζήτησης για τη γρήγορη τροποποίηση χρηστών και ομάδων

Το Βοήθημα καταλόγου χρησιμοποιεί ένα αρχείο ASCII στο οποίο ορίζονται όλες οι ομάδες, οι χρήστες και οι συνεδρίες. Το αρχείο κειμένου πρέπει να είναι σε μορφή XML, με προέκταση .xml.

	Εκτέλεση του Βοηθήματος καταλόγου
	Χρήση του γραφικού περιβάλλοντος χρήστη του Βοηθήματος καταλόγου
	Μορφή αρχείου XML: περιγραφές στοιχείων
	Παράδειγμα αρχείου XML
	Αναζήτηση με τη λειτουργία δημιουργίας λιστών
	Χρήση αποτελεσμάτων της λειτουργίας δημιουργίας λιστών

Εκτέλεση του Βοηθήματος καταλόγου

Το Βοήθημα καταλόγου μπορεί να εκτελεστεί είτε από ένα γραφικό περιβάλλον χρήστη είτε από τη γραμμή εντολών.

Γραφικό περιβάλλον χρήστη

Για να ενεργοποιήσετε το γραφικό περιβάλλον χρήστη ...

Στο γραφικό περιβάλλον χρήστη του Βοηθήματος καταλόγου, συμπληρώστε τις κατάλληλες τιμές στα ακόλουθα πεδία:

Ιδιότητες σύνδεσης

Ταυτότητα χρήστη: Η ταυτότητα χρήστη του διαχειριστή του Host On-Demand.
Κωδικός πρόσβασης: Ο κωδικός πρόσβασης του διαχειριστή του Host On-Demand.
Διεύθυνση υπολογιστή: Το όνομα υπολογιστή (hostname) ή η διεύθυνση IP της Διαχείρισης υπηρεσιών του Host On-Demand. Η συμπλήρωση αυτού του πεδίου είναι προαιρετική. Η προεπιλεγμένη τιμή είναι localhost (127.0.0.1).
Θύρα: Ο αριθμός θύρας της Διαχείρισης υπηρεσιών του Host On-Demand. Η συμπλήρωση αυτού του πεδίου είναι προαιρετική. Η προεπιλεγμένη τιμή είναι 8999.

Ενέργειες με αρχεία

Αρχείο XML εισόδου

Το όνομα του αρχείου XML που περιέχει τις ενέργειες που θέλετε να εκτελέσετε. Βλ. Μορφή αρχείου XML: περιγραφές στοιχείων.

Αναζήτηση: Πατήστε το για να αναζητήσετε το αρχείο XML εισόδου.

Δημιουργία αρχείου HTML για την ενέργεια δημιουργίας λίστας

Χρησιμοποιήστε αυτή την επιλογή όταν η ενέργεια στο αρχείο XML εισόδου είναι list, θα θέλετε να εμφανιστούν τα αποτελέσματα της λίστας σε ένα αρχείο εξόδου HTML.

Η επιλογή αυτή δεν λαμβάνεται υπόψη αν η ενέργεια στο αρχείο XML εισόδου είναι add, delete ή update.

Αποτελέσματα σε μορφή HTML

Το όνομα του αρχείου HTML εξόδου στο οποίο θα παρουσιάζονται τα αποτελέσματα της λίστας.

Αναζήτηση: Πατήστε το για να αναζητήσετε ένα υπάρχον αρχείο HTML εξόδου.

OK: Πατήστε το για να εκτελεστεί το Βοήθημα καταλόγου χρησιμοποιώντας το επιλεγμένο αρχείο XML εισόδου.
Ακύρωση: Πατήστε το για ακύρωση.
Βοήθεια: Πατήστε το για βοήθεια.

Δεδομένα εξόδου

Κονσόλα: Αυτή είναι η περιοχή εξόδου όπου εμφανίζεται μια περίληψη των αποτελεσμάτων των ενεργειών στο αρχείο XML εισόδου.
Εκκαθάριση: Πατήστε το για να γίνει εκκαθάριση της περιοχής της κονσόλας.

Περιβάλλον γραμμής εντολών

Στα συστήματα Windows, το αρχείο εντολών ή το αρχείο σεναρίου για την εκτέλεση του Βοηθήματος καταλόγου και το δείγμα αρχείου βρίσκονται στον κατάλογο C:\Program Files\IBM\HostOnDemand\lib\samples\DirUtil. Το αρχείο εντολών ονομάζεται DirUtil.cmd και το δείγμα αρχείου ονομάζεται sample.xml. Το αρχείο εντολών ή το αρχείο σεναρίου για τα άλλα λειτουργικά συστήματα βρίσκεται στον κατάλογο hostondemand\lib\samples\DirUtilCommandFiles. Το δείγμα αρχείου κειμένου ονομάζεται Sample.xml. Τα αρχεία εντολών ή τα αρχεία σεναρίου ονομάζονται:

DirUtil-AIX για το AIX
DirUtil-UNIX για το HP-UX, το Linux και το Solaris
DirUtil-AS400.sh για το iSeries, AS/400
DirUtil-S390 για το zSeries, OS/390

Για να ενεργοποιήσετε το Βοήθημα καταλόγου, πληκτρολογήστε τα ακόλουθα στη γραμμή εντολών:

Η σειρά των παραμέτρων είναι σημαντική.

DirUtil-xxx όνομα_αρχείου.xml admin κωδικός_πρόσβασης [όνομα_συστήματος] [θύρα] [COΝ | FILE]

όπου:

DirUtil-xxx είναι το αρχείο εντολών ή το αρχείο σεναρίου του Βοηθήματος καταλόγου για το λειτουργικό σύστημα που χρησιμοποιείτε

όνομα_αρχείου.xml είναι το αρχείο που περιέχει τα στοιχεία XML για τη διαχείριση χρηστών, ομάδων και συνεδριών. Το αρχείο κειμένου πρέπει να έχει την προέκταση .xml και να είναι έγκυρο αρχείο XML. Αν το αρχείο κειμένου δεν βρίσκεται στον ίδιο κατάλογο με το αρχείο εντολών του Βοηθήματος καταλόγου, πρέπει να καθορίσετε τη διαδρομή του αρχείου. Η παράμετρος αυτή πρέπει να περιλαμβάνεται στην εντολή.

admin είναι η ταυτότητα χρήστη του διαχειριστή του Host On-Demand. Η παράμετρος αυτή πρέπει να περιλαμβάνεται στην εντολή.

κωδικός_πρόσβασης είναι ο κωδικός πρόσβασης του διαχειριστή του Host On-Demand. Η παράμετρος αυτή πρέπει να περιλαμβάνεται στην εντολή.

όνομα_συστήματος είναι το όνομα ή η διεύθυνση IP της Διαχείρισης υπηρεσιών του Host On-Demand. Η παράμετρος αυτή είναι προαιρετική. Το προεπιλεγμένο όνομα συστήματος είναι localhost (127.0.0.1).

θύρα είναι η θύρα της Διαχείρισης υπηρεσιών του Host On-Demand. Η παράμετρος αυτή είναι προαιρετική. Η προεπιλεγμένη θύρα της Διαχείρισης υπηρεσιών είναι 8999.

CON | FILE είναι ο τρόπος καταγραφής και παρουσίασης των μηνυμάτων. Αν καθορίσετε την παράμετρο CON, τα μηνύματα θα εμφανίζονται μόνο στην κονσόλα. Αν καθορίσετε την παράμετρο FILE, τα μηνύματα θα καταγράφονται σε ένα αρχείο. Αν δεν καθορίσετε καμία από τις δύο παραμέτρους (προεπιλογή), τα μηνύματα θα εμφανίζονται στην κονσόλα και θα καταγράφονται σε ένα αρχείο. Το όνομα του αρχείου καταγραφής βασίζεται στο όνομα του αρχείου XML. Αν το όνομα του αρχείου XML είναι myxmlfile.xml, το όνομα του αρχείου καταγραφής θα είναι myxmlfile.log.

Για να έχει το Βοήθημα καταλόγου τη δυνατότητα να ενημερώνει τις πληροφορίες ρυθμίσεων του Host On-Demand ή του LDAP, πρέπει να είναι ενεργή η Διαχείριση υπηρεσιών του Host On-Demand στον εξυπηρετητή Host On-Demand που καθορίζεται στην παράμετρο όνομα_συστήματος.

Για παράδειγμα, σε σύστημα AIX θα μπορούσατε να εκτελέσετε την ακόλουθη εντολή:

DirUtil-AIX file.xml admin password myhostname 8999 CON

Χρήση του γραφικού περιβάλλοντος χρήστη του Βοηθήματος καταλόγου

Εναλλακτικά μπορείτε να εργαστείτε με το Βοήθημα καταλόγου χρησιμοποιώντας ένα γραφικό περιβάλλον χρήστη αντί για το περιβάλλον γραμμής εντολών. Μπορείτε να το χρησιμοποιήσετε για την εκτέλεση διαχειριστικών εργασιών με χρήστες, ομάδες ή ρυθμίσεις συνεδριών που έχουν αποθηκευτεί είτε στο Host On-Demand είτε σε έναν εξυπηρετητή LDAP. Το γραφικό περιβάλλον χρήστη του Βοηθήματος καταλόγου σάς επιτρέπει να προσθέσετε ή να ενημερώσετε μεγάλους αριθμούς χρηστών, ομάδων ή συνεδριών από ένα αρχείο ASCII, αντί να τους προσθέσετε χωριστά από το παράθυρο του Βοηθήματος διαχείρισης.

Στο φάκελο DirUtil παρέχεται ένα αρχείο sample.xml. Το αρχείο κειμένου πρέπει να είναι σε μορφή XML, με προέκταση .xml ώστε να μπορεί το γραφικό περιβάλλον χρήστη να αναγνωρίζει τις επιλογές στο αρχείο.

Εκτέλεση του γραφικού περιβάλλοντος χρήστη του Βοηθήματος καταλόγου

Σε ένα λειτουργικό σύστημα Windows 64 bit μπορείτε να εκκινήσετε το Βοήθημα καταλόγου εκτελώντας το αρχείο DirUtilGUI.bat που βρίσκεται στον κατάλογο C:\Program Files\IBM\HostOnDemand\lib\samples\DirUtil.

Σε ένα λειτουργικό σύστημα Windows 32 bit μπορείτε να εκκινήσετε το Βοήθημα καταλόγου εκτελώντας το αρχείο DirUtilGUI.bat που βρίσκεται στον κατάλογο C:\Program Files (x86)\IBM\HostOnDemand\lib\samples\DirUtil.

Σε ένα λειτουργικό σύστημα Unix/Linuxd μπορείτε να εκκινήσετε το Βοήθημα καταλόγου εκτελώντας το αρχείο DirUtilGUI.sh που βρίσκεται στον κατάλογο /opt/IBM/HostOnDemand/lib/samples/DirUtil.

Σημείωση: Πρόκειται για τους προεπιλεγμένους καταλόγους εγκατάστασης του HOD. Σε περίπτωση που το HOD έχει εγκατασταθεί σε κάποιον καθορισμένο από το χρήστη κατάλογο, η θέση του αρχείου θα είναι <<HOD_INSTALL_DIRECTORY>>\lib\samples\DirUtil. Τα αρχεία εντολών ή τα αρχεία σεναρίου ονομάζονται:

DirUtilGUI.bat για Windows
DirUtilGUI-UNIX για Linux και Solaris

Διεπαφή του γραφικού περιβάλλοντος χρήστη

Στα πεδία Όνομα χρήστη και Κωδικός πρόσβασης του γραφικού περιβάλλοντος χρήστη πρέπει να συμπληρωθούν το όνομα χρήστη και ο κωδικός πρόσβασης ενός διαχειριστή. Η προεπιλεγμένες τιμές είναι admin για το όνομα χρήστη και password για τον κωδικό πρόσβασης

Οι προεπιλεγμένες τιμές για το όνομα υπολογιστή και τον αριθμό θύρας είναι localhost και 8999, αντίστοιχα. Μπορείτε να καταχωρήσετε διαφορετικό όνομα υπολογιστή και αριθμό θύρας αν είναι απαραίτητο.

Θα πρέπει να επιλέξετε το αρχείο XML που περιέχει τις λεπτομέρειες για το χρήστη, την ομάδα ή τη συνεδρία. Οι διαθέσιμες επιλογές είναι Προσθήκη (Add), Ενημέρωση (Update) και Διαγραφή (Delete).

Αν επιλεγεί το τετραγωνίδιο Δημιουργία αρχείου HTML για ενέργεια δημιουργίας λίστας, δημιουργείται μια λίστα των χρηστών ή ομάδων σύμφωνα με την επιλογή που ορίστηκε στο αρχείο XML. Το πεδίο Αρχείο HTML δημιουργείται αυτόματα όταν επιλεγεί το αρχείο XML. Το αρχείο HTML λαμβάνει αυτόματα το ίδιο όνομα με το αρχείο XML και τοποθετείται στον ίδιο κατάλογο.

Δημιουργείται μια λίστα του (των) χρήστη(-ών) ή της (των) ομάδας(-ων) στο αρχείο HTML μόνο αν έχει επιλεγεί το τετραγωνίδιο Δημιουργία αρχείου HTML για ενέργεια δημιουργίας λίστας. Η λίστα του (των) χρήστη(-ών) ή της (των) ομάδας(-ων) δημιουργείται στο προεπιλεγμένο αρχείο HTML, εκτός εάν το αλλάξετε.

Μπορείτε να εκκαθαρίσετε τα αποτελέσματα που εμφανίζονται στην κονσόλα πατώντας το κουμπί Εκκαθάριση. Μπορείτε επίσης να τα αντιγράψετε στο πρόχειρο πατώντας το κουμπί Αντιγραφή.

Μπορείτε να πατήσετε το κουμπί Βοήθεια για να ανοίξετε τη βοήθεια για το γραφικό περιβάλλον χρήστη του Βοηθήματος καταλόγου.

Χρήση αποτελεσμάτων της λειτουργίας δημιουργίας λιστών

Ακολουθούν δύο παραδείγματα της ενέργειας δημιουργίας λίστας στο αρχείο HTML:

Λίστα χρήστη(-ών)

            <action type = "list">
      <userlist>
         <userid>*</userid>
      </userlist>
            </action>

Λίστα ομάδας(-ων)

            <action type = "list">
      <grouplist>
         <groupid>*</groupid>
      </grouplist>
            </action>

Μορφή αρχείου XML: περιγραφές στοιχείων

Στην ενότητα αυτή περιγράφεται η μορφή των έγκυρων στοιχείων XML που μπορούν να συμπεριληφθούν στο αρχείο XML που χρησιμοποιείται από το Βοήθημα καταλόγου. Θα πρέπει να κατανοείτε τις βασικές έννοιες του κώδικα XML. Οι γραμμές που αρχίζουν από "" θεωρούνται σχόλια. Στα ονόματα των στοιχείων διακρίνονται οι κεφαλαίοι από τους πεζούς χαρακτήρες.

Για να δημιουργήσετε ή να τροποποιήσετε το αρχείο XML, θα πρέπει να χρησιμοποιήσετε έναν κειμενογράφο ASCII που δημιουργεί έγκυρους χαρακτήρες Unicode. Αν παρουσιαστεί το μήνυμα σφάλματος DIR0037 Μοιραίο σφάλμα: Μη έγκυρος χαρακτήρας XML καθώς χρησιμοποιείτε το αρχείο XML με το Βοήθημα καταλόγου, τότε ο κειμενογράφος ASCII δεν δημιουργεί έγκυρους χαρακτήρες Unicode. Στην περίπτωση αυτή, χρησιμοποιήστε ένα διαφορετικό κειμενογράφο που δημιουργεί έγκυρους χαρακτήρες Unicode.

<dirscript>
    <action>

        <group>
            <groupid>
            <description>
            <parent>
            <removeusers>
   
        <user>
            <userid>
            <groupid>
            <description>
            <authentication>
                <pw>
                <nativeid>
            <savepref>
   
        <session>
            <filename>
            <groupid>
            <userid>
            <description>

        <userlist>
            <userid>
            <groupid>
            <filename>

        <grouplist>
            <userid>
            <groupid>
            <filename>

<dirscript>..</dirscript>

Το αρχικό στοιχείο σε ένα αρχείο XML, το οποίο περιέχει όλα τα άλλα στοιχεία και προσδιορίζει ότι είναι δυνατή η επεξεργασία του εγγράφου με το Βοήθημα καταλόγου.

Γνωρίσματα: κανένα

Απαιτούμενα στοιχεία: <action type=xxx>

Προαιρετικά στοιχεία: κανένα

<action type=xxx>..</action>

Η ενέργεια που εκτελείται με τα στοιχεία που περιλαμβάνονται στο στοιχείο <action>. Μπορείτε να συμπεριλάβετε περισσότερα από ένα στοιχεία action στο στοιχείο <dirscript>. Τα στοιχεία που βρίσκονται έξω από το στοιχείο <dirscript> ή έξω από αυτό το στοιχείο στο αρχείο XML αγνοούνται από το Βοήθημα καταλόγου.

Τιμές: add, delete, update ή list

Απαιτούμενα στοιχεία: Τουλάχιστον ένα από τα ακόλουθα πρέπει να περιλαμβάνεται στο στοιχείο <action>:

<group>..</group>: Η ομάδα που επηρεάζεται από την ενέργεια. Αν η ενέργεια είναι add και η ομάδα υπάρχει ήδη, θα εμφανιστεί ένα μήνυμα που σας πληροφορεί ότι η ομάδα υπάρχει.
<user>..</user>: Ο χρήστης που επηρεάζεται από την ενέργεια. Αν η ενέργεια είναι add και ο χρήστης υπάρχει ήδη, θα εμφανιστεί ένα μήνυμα που σας πληροφορεί ότι ο χρήστης υπάρχει.
<session>..</session>: Η συνεδρία που επηρεάζεται από την ενέργεια. Το στοιχείο session δεν είναι έγκυρο όταν η ενέργεια είναι update. Αν η συνεδρία υπάρχει ήδη, θα προστεθεί μια νέα συνεδρία με το όνομα "1:περιγραφή", όπως συμβαίνει όταν ο πελάτης διαχείρισης προσθέτει μια διπλότυπη συνεδρία.
<userlist>..</userlist>: Είναι έγκυρο μόνο όταν η ενέργεια είναι list. Δημιουργεί ένα αρχείο εξόδου XML με πληροφορίες για συγκεκριμένους χρήστες. Βλ. την ενότητα Αναζήτηση με τη λειτουργία δημιουργίας λιστών.
<grouplist>..</grouplist>: Είναι έγκυρο μόνο όταν η ενέργεια είναι list. Δημιουργεί ένα αρχείο εξόδου XML με πληροφορίες για συγκεκριμένες ομάδες χρηστών. Βλ. την ενότητα Αναζήτηση με τη λειτουργία δημιουργίας λιστών.

Το Βοήθημα καταλόγου δεν υποστηρίζει το στοιχείο <grouplist> για το LDAP.

<group>..</group>

Το στοιχείο που περιλαμβάνει τον ορισμό μιας ομάδας.

Γνωρίσματα: κανένα

Απαιτούμενα στοιχεία:

<groupid>..</groupid>: Μια σειρά χαρακτήρων unicode που προσδιορίζει την ομάδα στο LDAP ή στο Host On-Demand. Αν χρησιμοποιείτε το Host On-Demand, το στοιχείο groupid μετατρέπεται σε κεφαλαίους χαρακτήρες όταν προστίθεται η ομάδα. Αν χρησιμοποιείτε το LDAP, το στοιχείο groupid μπορεί να περιέχει ανάμικτους κεφαλαίους και πεζούς χαρακτήρες.

Προαιρετικά στοιχεία:

<description>..</description>: Μια σειρά χαρακτήρων unicode που περιγράφει την ομάδα. Το στοιχείο αυτό είναι έγκυρο μόνο όταν η ενέργεια είναι add ή update.
<parent>..</parent>: Η γονική ομάδα για την ομάδα αυτή. Το στοιχείο αυτό είναι έγκυρο μόνο όταν η ενέργεια είναι add ή update και όταν χρησιμοποιείτε το LDAP. Αν η ενέργεια είναι add και δεν καθοριστεί αυτό το στοιχείο, η ομάδα προστίθεται στο πρώτο επίπεδο.
<removeusers>..</removeusers>: Όταν διαγράφετε μια ομάδα, το στοιχείο αυτό σας επιτρέπει να διαγράψετε όλους τους χρήστες που ανήκουν στη συγκεκριμένη ομάδα μόνο. Το στοιχείο αυτό είναι έγκυρο μόνο όταν η ενέργεια είναι delete και δεν είναι έγκυρο όταν χρησιμοποιείτε το LDAP. Οι έγκυρες τιμές είναι Yes ή No. Αν καθορίσετε Yes, οι χρήστες στην ομάδα θα διαγραφούν όταν διαγραφεί η ομάδα. Αν καθορίσετε No και υπάρχουν χρήστες στην ομάδα, οι χρήστες αυτοί θα μεταφερθούν στην ομάδα HOD και η ομάδα θα διαγραφεί.

Η προεπιλεγμένη τιμή είναι No.

Αν υπάρχουν πολλοί χρήστες, μπορεί να χρειαστεί αρκετός χρόνος για την επεξεργασία αυτού του στοιχείου.

<user>..</user>

Το στοιχείο που περιλαμβάνει τον ορισμό ενός χρήστη.

Γνωρίσματα: κανένα

Απαιτούμενα στοιχεία:

<userid>..</userid>: Η ταυτότητα του χρήστη. Το στοιχείο αυτό απαιτείται πάντα. Αν χρησιμοποιείτε το Host On-Demand, το στοιχείο userid μετατρέπεται σε πεζούς χαρακτήρες. Αν χρησιμοποιείτε το LDAP, το στοιχείο userid μπορεί να περιέχει ανάμικτους κεφαλαίους και πεζούς χαρακτήρες.
<groupid>..</groupid>: Η ομάδα στην οποία προστίθεται ο χρήστης. Το στοιχείο αυτό είναι απαραίτητο όταν η ενέργεια είναι add και αγνοείται όταν η ενέργεια είναι delete. Αν δεν χρησιμοποιείτε το LDAP, μπορείτε να καθορίσετε περισσότερα από ένα στοιχεία <groupid>. Αν χρησιμοποιείτε το LDAP και καθορίσετε περισσότερες από μία ομάδες, θα εμφανιστεί ένα μήνυμα σφάλματος και ο χρήστης δεν θα προστεθεί. Οι ομάδες που καθορίζετε πρέπει να υπάρχουν για να είναι δυνατή η προσθήκη του χρήστη σε αυτές. Αν η ενέργεια είναι update, ο χρήστης ενημερώνεται και γίνεται μέλος της συγκεκριμένης ομάδας.

Προαιρετικά στοιχεία:

<description>..</description>: Μια σειρά χαρακτήρων unicode που περιγράφει το χρήστη.
<authentication type=xxx>..</authentication>: Μπορείτε να καθορίσετε το είδος της εξακρίβωσης στοιχείων που θα χρησιμοποιείται για το χρήστη. Έγκυρα είδη εξακρίβωσης στοιχείων είναι native και pw. Αν δεν καθορίσετε αυτό το στοιχείο, δεν εκτελείται εξακρίβωση στοιχείων για το χρήστη.
<savepref>..</savepref>: Μπορείτε να καθορίσετε αν ο χρήστης έχει τη δυνατότητα να αποθηκεύει προτιμήσεις (αλλαγές που ο χρήστης μπορεί να κάνει στις ρυθμίσεις μιας συνεδρίας). Οι έγκυρες τιμές είναι Yes ή No. Αν δεν καθοριστεί το στοιχείο αυτό, χρησιμοποιείται η προεπιλεγμένη τιμή Yes, που σημαίνει ότι ο χρήστης έχει τη δυνατότητα να αποθηκεύει προτιμήσεις.
<removegroupid>..</removegroupid>: Μπορείτε να ενημερώσετε ένα χρήστη ώστε να μην αποτελεί πλέον μέλος της καθορισμένης ομάδας. Το στοιχείο αυτό είναι έγκυρο μόνο όταν η ενέργεια είναι update. Πρέπει να καθορίσετε μια έγκυρη ταυτότητα ομάδας στην οποία ανήκει ο χρήστης.

<authentication type=xxx>..</authentication>

Το είδος της εξακρίβωσης στοιχείων που χρησιμοποιείται για το χρήστη. Μπορεί να χρησιμοποιηθεί τοπική εξακρίβωση στοιχείων, μόνο αν χρησιμοποιείτε το LDAP, ή εξακρίβωση στοιχείων μέσω κωδικού πρόσβασης. Δεν θα χρησιμοποιηθεί κανένα είδος εξακρίβωσης στοιχείων αν δεν καθορίσετε αυτό το στοιχείο και η ενέργεια είναι add, ή αν επιλέξετε native και δεν χρησιμοποιείτε το LDAP.

Γνωρίσματα: pw ή native

Απαιτούμενα στοιχεία:

<nativeid>..</nativeid>: Η ταυτότητα του χρήστη στο τοπικό λειτουργικό σύστημα. Το στοιχείο αυτό είναι απαραίτητο και είναι έγκυρο μόνο αν χρησιμοποιείτε LDAP και το είδος εξακρίβωσης στοιχείων είναι native.

Προαιρετικά στοιχεία:

<pw>..</pw>: Ο κωδικός πρόσβασης για το χρήστη. Το στοιχείο αυτό είναι έγκυρο μόνο όταν το είδος εξακρίβωσης στοιχείων είναι pw.
<changepw>..</changepw>: Μπορείτε να καθορίσετε αν ο χρήστης έχει τη δυνατότητα να αλλάζει τον κωδικό πρόσβασής του. Οι έγκυρες τιμές είναι Yes ή No. Αν δεν καθοριστεί το στοιχείο αυτό, χρησιμοποιείται η προεπιλεγμένη τιμή Yes, που σημαίνει ότι ο χρήστης έχει τη δυνατότητα να αλλάζει τον κωδικό πρόσβασης. Το στοιχείο αυτό είναι έγκυρο μόνο αν το είδος εξακρίβωσης στοιχείων είναι pw και αγνοείται αν το είδος εξακρίβωσης στοιχείων είναι native.

<session>..</session>

Το στοιχείο που περιλαμβάνει τον ορισμό μιας συνεδρίας.

Γνωρίσματα: κανένα

Απαιτούμενα στοιχεία:

<filename>..</filename>: Το αρχείο που περιέχει τον ορισμό της συνεδρίας. Μπορείτε να δημιουργήσετε ένα αρχείο ορισμού συνεδρίας χρησιμοποιώντας την επιλογή Εξαγωγή συνεδρίας από οποιαδήποτε συνεδρία που έχετε ορίσει στο Host On-Demand. Η προεπιλεγμένη προέκταση για τα αρχεία συνεδρίας είναι .hod. Το στοιχείο <filename> μπορεί να περιέχει την πλήρη διαδρομή του αρχείου συνεδρίας, και είναι απαραίτητο μόνο κατά την προσθήκη μιας συνεδρίας.
<description>..</description>: Μια σειρά χαρακτήρων unicode που περιγράφει τη συνεδρία και χρησιμοποιείται ως όνομα της συνεδρίας. Το στοιχείο <description> είναι απαραίτητο για την ενημέρωση ή τη διαγραφή μιας συνεδρίας. Αν παραλείψετε το στοιχείο <description>, θα χρησιμοποιηθεί ως περιγραφή το όνομα της συνεδρίας.
<userid>..</userid>: Η ταυτότητα του χρήστη στον οποίο θα προστεθεί η συνεδρία. Οι ταυτότητες χρήστη πρέπει να υπάρχουν για να είναι δυνατή η προσθήκη της συνεδρίας. Μπορείτε να συμπεριλάβετε περισσότερα από ένα στοιχεία <userid> για να προσθέσετε τη συνεδρία σε περισσότερους από έναν χρήστες.
<groupid>..</groupid>: Η ταυτότητα της ομάδας στην οποία θα προστεθεί η συνεδρία. Οι ομάδες πρέπει να υπάρχουν για να είναι δυνατή η προσθήκη της συνεδρίας. Μπορείτε να συμπεριλάβετε περισσότερα από ένα στοιχεία <groupid> για να προσθέσετε τη συνεδρία σε περισσότερες από μία ομάδες.

Μπορείτε να καθορίσετε περισσότερους από έναν χρήστες ή περισσότερες από μία ομάδες στο στοιχείο session, αλλά δεν μπορείτε να καθορίσετε και χρήστες και ομάδες στο ίδιο στοιχείο session.

Προαιρετικά στοιχεία: κανένα

<userlist>..</userlist>

Το στοιχείο που περιλαμβάνει τον ορισμό μιας αναζήτησης χρηστών.

Γνωρίσματα: κανένα

Απαιτούμενα στοιχεία: Δεν μπορείτε να χρησιμοποιήσετε περισσότερα από ένα από τα ακόλουθα στοιχεία:

<userid>..</userid>: Η ταυτότητα χρήστη που θα χρησιμοποιείται στα κριτήρια αναζήτησης.

<groupid>..</groupid>: Η ταυτότητα ομάδας που θα χρησιμοποιείται στα κριτήρια αναζήτησης.

Αν λείπει το προσδιοριστικό <userid> ή <groupid>, το Βοήθημα καταλόγου χρησιμοποιεί ένα χαρακτήρα υποκατάστασης για το στοιχείο και εκτελεί την αναζήτηση ανάλογα.

Προαιρετικά στοιχεία: Χρησιμοποιήστε αυτό το στοιχείο μόνο μία φορά, ώστε να παραπέμπει σε ένα συγκεκριμένο αρχείο:

<filename>..</filename>: Το αρχείο στο οποίο το Βοήθημα καταλόγου εγγράφει τα αποτελέσματα XML. Θα πρέπει να καθορίσετε ένα έγκυρο όνομα αρχείου XML για αυτό το αρχείο.

Αν δεν καθορίσετε ένα όνομα αρχείου, το Βοήθημα καταλόγου εγγράφει τα αποτελέσματα σε ένα προεπιλεγμένο αρχείο. Το προεπιλεγμένο αρχείο ονομάζεται DirUtilList.xml και βρίσκεται στον κατάλογο hostondemand\lib\samples\DirUtil. Κάθε φορά που παραλείπετε τον καθορισμό ενός αρχείου εξόδου, η λειτουργία δημιουργίας λιστών (list) προσθέτει τα αποτελέσματα της αναζήτησής σας στο αρχείο DirUtilList.xml. Βλ. την ενότητα Χρήση αποτελεσμάτων της λειτουργίας δημιουργίας λιστών.

<grouplist>..</grouplist>

Το στοιχείο που περιλαμβάνει τον ορισμό μιας αναζήτησης ομάδων.

Το Βοήθημα καταλόγου δεν υποστηρίζει αυτό το στοιχείο για το LDAP.

Γνωρίσματα: κανένα

Απαιτούμενα στοιχεία: Δεν μπορείτε να χρησιμοποιήσετε περισσότερα από ένα από τα ακόλουθα στοιχεία:

<userid>..</userid>: Η ταυτότητα χρήστη που θα χρησιμοποιείται στα κριτήρια αναζήτησης.

<groupid>..</groupid>: Η ταυτότητα ομάδας που θα χρησιμοποιείται στα κριτήρια αναζήτησης.

<filename>..</filename>: Το αρχείο στο οποίο το Βοήθημα καταλόγου εγγράφει τα αποτελέσματα XML. Θα πρέπει να καθορίσετε ένα έγκυρο όνομα αρχείου XML για αυτό το αρχείο.

Παράδειγμα αρχείου XML

Ακολουθεί ένα παράδειγμα ενός αρχείου XML στο οποίο ορίζονται οι ενέργειες add και list. Το αρχείο XML προσθέτει τρεις ομάδες, προσθέτει χρήστες στις ομάδες και, αν εξαχθούν οι συνεδρίες και αφαιρεθούν τα σχόλια, προσθέτει τις συνεδρίες στους χρήστες και τις ομάδες. (Για να διαγράψετε ή να ενημερώσετε χρήστες, ομάδες ή συνεδρίες, αλλάξτε το είδος της ενέργειας σε delete ή update και κάντε τις κατάλληλες αλλαγές στα στοιχεία.) Στα Windows NT και στα Windows 2000, αυτό το υπόδειγμα αρχείου, που ονομάζεται sample.xml, βρίσκεται στον κατάλογο C:\Program Files\IBM\HostOnDemand\lib\samples\DirUtil. Το αρχείο κειμένου sample.xml για τα άλλα λειτουργικά συστήματα βρίσκεται στον κατάλογο hostondemand\lib\samples\DirUtilCommandFiles.

Σε αυτό το παράδειγμα χρησιμοποιείται η ενέργεια list στην πιο απλή της μορφή: αποστέλλει μια λίστα όλων των χρηστών και ομάδων στο προεπιλεγμένο αρχείο XML εξόδου του Βοηθήματος καταλόγου. Για να μάθετε πώς μπορείτε να εκτελέσετε πιο σύνθετες αναζητήσεις και πώς να χρησιμοποιήσετε τα αποτελέσματά τους, ανατρέξτε στην ενότητα Αναζήτηση με τη λειτουργία δημιουργίας λιστών.

<?xml version="1.0" encoding="UTF-8"?>

<!-- Begin DTD - The DTD should not be modified.-->
<!DOCTYPE dirscript [
<!ELEMENT dirscript (action)+>
<!ELEMENT action (group | user | session)+>
<!ELEMENT group (groupid, description?, parent?, removeusers?)>
<!ELEMENT user (userid, groupid*, description?, authentication?, savepref?, removegroupid?)>
<!ELEMENT session (filename?, (groupid | userid)+, description?)>
<!ELEMENT groupid (#PCDATA)>
<!ELEMENT userid (#PCDATA)>
<!ELEMENT description (#PCDATA)>
<!ELEMENT userlist (userid+, groupid+, filename+)>
<!ELEMENT grouplist (userid+, groupid+, filename+)>
<!ELEMENT parent (#PCDATA)>
<!ELEMENT removeusers (#PCDATA)>
<!ELEMENT removegroupid (#PCDATA)>
<!ELEMENT authentication ((pw?, changepw?) | (nativeid))>
<!ELEMENT pw (#PCDATA)>
<!ELEMENT changepw (#PCDATA)>
<!ELEMENT nativeid (#PCDATA)>
<!ELEMENT savepref (#PCDATA)>
<!ELEMENT filename (#PCDATA)>
   <!ATTLIST action type (add | delete | update | list) #REQUIRED>
   <!ATTLIST authentication type (pw | native) #REQUIRED>
]>
<!-- End DTD -->


<dirscript>
	<action type="add">
<!-- Προσθήκη τριών ομάδων -->
		<group>
			<groupid>3270GROUP</groupid>
			<description>Ομάδα με συνεδρίες 3270</description>
		</group>
		<group>
			<groupid>5250GROUP</groupid>
			<description>Ομάδα με συνεδρίες 5250</description>
		</group>
		<group>
			<groupid>mygroup</groupid>
			<description>Ομάδα με γονική ομάδα</description>
			<!-- το στοιχείο parent πρέπει να καθοριστεί μόνο αν χρησιμοποιείται LDAP -->
			<!-- <parent>3270GROUP</parent>	-->
		</group>

<!-- Προσθήκη χρήστη στην ομάδα 3270 και καθορισμός κωδικού πρόσβασης. -->
      <user>
         <userid>user1</userid>
         <description>Πρώτος χρήστης</description>
         <authentication type="pw">
            <pw>mypw</pw>
            <changepw>yes</changepw>
         </authentication>
         <groupid>3270GROUP</groupid>
      </user>

<!-- Προσθήκη χρήστη στην ομάδα 5250 χωρίς δυνατότητα αποθήκευσης προτιμήσεων -->
      <user>
         <userid>user2</userid>
         <description>Δεύτερος χρήστης</description>
         <authentication type="pw">
            <pw>mypw</pw>
            <changepw>yes</changepw>
         </authentication>
         <groupid>3270GROUP</groupid>
         <savepref>no</savepref>
      </user>

<!-- Τα στοιχεία session έχουν προστεθεί ως σχόλια γιατί το αρχείο μπορεί να μην υπάρχει. -->
<!-- Αν θέλετε να προσθέσετε μια συνεδρία, εξαγάγετε τη συνεδρία με το σωστό όνομα -->
<!-- αρχείου και αφαιρέστε τα προσδιοριστικά σχολίου πριν εκτελέσετε το DirUtil. -->

<!-- Προσθήκη συνεδρίας στην ομάδα 3270 -->
<!--
		<session>
			<description>Οθόνη 3270</description>
			<filename>3270dsp.hod</filename>
			<groupid>3270GROUP</groupid>
		</session>
-->

<!-- Προσθήκη συνεδρίας στην ομάδα 5250 -->
<!--
		<session>
			<description>Οθόνη 5250</description>	
			<filename>5250dsp.hod</filename>
			<groupid>5250GROUP</groupid>
		</session>
-->

<!-- Προσθήκη συνεδρίας στο χρήστη user1 -->
<!--
		<session>
			<description>Εκτυπωτής 3270</description>		
			<filename>3270prt.hod</filename>		
			<userid>user1</userid>			
		</session>
-->

                </action>

<!-- Δημιουργία λίστας όλων των χρηστών και ομάδων στο σύστημα και αποστολή -->
<!-- των αποτελεσμάτων στο προεπιλεγμένο αρχείο εξόδου XML -->
<!--
    <action type = "list">
                <userlist>
                         <userid>*</userid>
                </userlist>
                <grouplist>
                          <userid>*</userid>
                          <groupid>*</groupid>
                </grouplist>
    </action>
-->
</dirscript>

Αναζήτηση με τη λειτουργία δημιουργίας λιστών

	Εισαγωγή στην αναζήτηση χρηστών και ομάδων
	Χρήση χαρακτήρων υποκατάστασης
	Παραδείγματα αναζήτησης

Εισαγωγή στην αναζήτηση χρηστών και ομάδων
Μπορείτε να ενεργοποιήσετε τη λειτουργία δημιουργίας λιστών (list) ορίζοντάς την ως τιμή για ένα είδος ενέργειας: <action type="list">. Στη συνέχεια καθορίζετε ένα από δύο είδη αναζήτησης (ή και τα δύο είδη αναζήτησης), τα οποία αφορούν σε υπάρχοντες χρήστες και ομάδες μόνο:

Αναζήτηση χρηστών, που ορίζεται μέσω του στοιχείου <userlist>. Μια αναζήτηση τύπου <userlist> επιστρέφει πληροφορίες για χρήστες: ταυτότητα χρήστη, ταυτότητα ομάδας, περιγραφή και είδος εξακρίβωσης στοιχείων. Παράδειγμα.
Αναζήτηση ομάδων, που ορίζεται μέσω του στοιχείου <grouplist>. Μια αναζήτηση τύπου <grouplist> επιστρέφει πληροφορίες για ομάδες: ταυτότητα ομάδας, επιστροφή. Παράδειγμα.

Η αναζήτηση ομάδων δεν υποστηρίζεται για το LDAP.

Και για τα δύο είδη αναζήτησης μπορείτε να ορίσετε κριτήρια μόνο χρησιμοποιώντας τα στοιχεία <userid> και <groupid>. Όμως, σας παρέχεται η ευελιξία να συμπεριλάβετε χαρακτήρες υποκατάστασης (wildcards) στα κριτήρια αναζήτησης. Επειδή μπορείτε να χρησιμοποιήσετε οποιονδήποτε αριθμό χαρακτήρων υποκατάστασης, τους οποίους μπορείτε να τοποθετήσετε σε οποιαδήποτε θέση της συμβολοσειράς αναζήτησης, μπορείτε να κάνετε την αναζήτηση όσο γενική θέλετε.

Προεπιλεγμένα κριτήρια: Όταν δεν καθορίσετε ένα από τα στοιχεία <userid> ή <groupid> (ή αν δεν καθορίσετε κανένα από τα δύο στοιχεία), η λειτουργία list χρησιμοποιεί ως προεπιλεγμένο κριτήριο ένα χαρακτήρα υποκατάστασης για το στοιχείο(-α). Έτσι εξασφαλίζεται ότι η αναζήτηση είναι όσο γίνεται πιο ανοιχτή.

Το Βοήθημα καταλόγου τοποθετεί τα αποτελέσματα της αναζήτησης σε ένα αρχείο XML.

Χρήση χαρακτήρων υποκατάστασης
Ο χαρακτήρας υποκατάστασης (wildcard) είναι ο αστερίσκος (*).

Το Βοήθημα καταλόγου υποστηρίζει την τοποθέτηση του αστερίσκου σε οποιαδήποτε θέση της τιμής των δύο προσδιοριστικών που μπορούν να λειτουργούν ως κριτήρια αναζήτησης: <groupid> και <userid>. Μπορείτε να τοποθετήσετε αστερίσκους σε ένα από τα δύο στοιχεία, και στα δύο στοιχεία ή σε κανένα από τα δύο στοιχεία. Μπορείτε να τοποθετήσετε όσους αστερίσκους θέλετε, με ή χωρίς αλφαριθμητικούς χαρακτήρες ανάμεσά τους. Αν παραλείψετε ένα από τα δύο προσδιοριστικά ταυτότητας από τα κριτήρια αναζήτησης, το Βοήθημα καταλόγου χρησιμοποιεί στη θέση του στοιχείου ένα χαρακτήρα υποκατάστασης (*) και εκτελεί την αναζήτηση για αυτό το προσδιοριστικό ως προεπιλεγμένη ρύθμιση.

Παραδείγματα της τοποθέτησης χαρακτήρων υποκατάστασης:

*<userid></userid>**	Όλοι οι χρήστες
*<groupid></groupid>**	Όλες οι ομάδες
*<userid>a</userid> <groupid></groupid>*	Οι χρήστες που η ταυτότητά τους αρχίζει με "a", ανεξάρτητα από την ομάδα στην οποία ανήκουν
*<userid>as</userid> <groupid>hod</groupid>**	Οι χρήστες που η ταυτότητα τους αρχίζει με "a" και τελειώνει με "s" και που ανήκουν στην ομάδα hod
<userid>ygeorgiou</userid> <groupid>hod</groupid>	Ο χρήστης "ygeorgiou" στην ομάδα hod

Παραδείγματα αναζήτησης
Παραδείγματα στα οποία συνδυάζονται όλα τα στοιχεία της λειτουργίας δημιουργίας λιστών (list):

<userlist> <userid></userid> <groupid></groupid> <filename>my.xml</filename> </userlist>	Εκτέλεση αναζήτησης χρηστών (επιστροφή πληροφοριών χρηστών) για όλους τους χρήστες σε όλες τις ομάδες, και αποστολή των αποτελεσμάτων στο αρχείο my.xml.
<grouplist> <userid>a*</userid> <groupid>hod</groupid> <filename>your.xml</filename> </grouplist>	Εκτέλεση αναζήτησης ομάδας (επιστροφή πληροφοριών ομάδων) για την ομάδα hod που περιλαμβάνει μια ταυτότητα χρήστη που αρχίζει από "a", και αποστολή των αποτελεσμάτων στο αρχείο your.xml.

Οι γενικές συγκεντρωτικές πληροφορίες για τη λειτουργία list, όπως μια μέτρηση των αναζητήσεων που εκτελέστηκαν, έχουν την ίδια δομή με τις άλλες συγκεντρωτικές πληροφορίες του Βοηθήματος καταλόγου. Μπορείτε να ορίσετε την αποστολή των συγκεντρωτικών πληροφοριών για τη λειτουργία list στην κονσόλα, σε ένα αρχείο καταγραφής ή και στα δύο.

Χρήση αποτελεσμάτων της λειτουργίας δημιουργίας λιστών

Επειδή τα αποτελέσματα της λειτουργίας δημιουργίας λιστών (list) εγγράφονται όλα σε ένα αρχείο XML, μπορείτε να τα χρησιμοποιήσετε άμεσα ως δεδομένα εισόδου για άλλες λειτουργίες του Βοηθήματος καταλόγου. Στο αρχείο εξόδου XML, θα πρέπει απλώς να αλλάξετε το είδος ενέργειας από list σε add, delete ή modify.

Αν καθορίσετε ένα όνομα αρχείου εξόδου (με το προσδιοριστικό <filename>) κατά την καταχώρηση των κριτηρίων αναζήτησης, το Βοήθημα καταλόγου εγγράφει τα αποτελέσματα της αναζήτησης στον κατάλογο και στο αρχείο που καθορίσατε. Βλ. Παραδείγματα αναζήτησης. Αν δεν καθορίσετε ένα όνομα αρχείου εξόδου, το Βοήθημα καταλόγου αποθηκεύει τα αποτελέσματα στο προεπιλεγμένο αρχείο DirUtilList.xml, το οποίο βρίσκεται στον κατάλογο hostondemand\lib\samples\DirUtil. Κάθε φορά που παραλείπετε τον προσδιορισμό ενός αρχείου εξόδου, η λειτουργία list προσθέτει τα αποτελέσματα της αναζήτησής σας στο αρχείο DirUtilList.xml.

Αν καθορίσετε κατά λάθος μια διαδρομή αρχείου που δεν υπάρχει, το Βοήθημα καταλόγου θα τοποθετήσει τα αποτελέσματα στο προεπιλεγμένο αρχείο, προσθέτοντάς τα στα υπάρχοντα περιεχόμενα του αρχείου.

Για περιβάλλοντα Unix: Εξασφαλίστε ότι τα ονόματα των διαδρομών για τα αρχεία εξόδου XML είναι έγκυρα γα το συγκεκριμένο λειτουργικό σύστημα Unix που χρησιμοποιείτε. Για παράδειγμα, αν το λειτουργικό σύστημα δεν αναγνωρίζει όλους τους χαρακτήρες στο όνομα της διαδρομής του αρχείου σας, το όνομα αρχείου μπορεί να μη θεωρείται έγκυρο. Το αποτέλεσμα μπορεί να είναι ότι δεν θα μπορέσετε να ανοίξετε το αρχείο εξόδου και να ανακτήσετε τα αποτελέσματα της αναζήτησης.

Παράδειγμα αποτελεσμάτων
Αν καθορίσετε τα ακόλουθα κριτήρια αναζήτησης:

            <dirscript>
            <action type="list">
      <userlist>
         <userid>*</userid>
         <groupid>*</groupid>
      </userlist>
      <grouplist>
         <userid>*</userid>
         <groupid>*</groupid>
      </grouplist>
   <action>
            <dirscript>

Θα τοποθετηθούν τα ακόλουθα αποτελέσματα στο προεπιλεγμένο αρχείο XML, DirUtilList.xml:
(Για να είστε σε θέση να ξεχωρίσετε τα αποτελέσματα των αναζητήσεών σας, το Βοήθημα καταλόγου εμφανίζει τα αρχικά σας κριτήρια ως σχόλια στην αρχή του αρχείου.)

<!--Αναζήτηση βάσει:    Userlist -->
<!--με:                 userid= * -->
<!--                    groupid= * -->

            <dirscript>
            <action type="list">
                <user>
                    <userid>user1</userid>
                    <groupid>hod</groupid>
                    <description></description>
                    <authentication>pw</authentication>
                </user>
                <user>
                    <userid>user2</userid>
                    <groupid>group2</groupid>
                    <description></description>
                    <authentication>nativeid</authentication>
                </user>
            </action>
            </dirscript>


<!--Αναζήτηση βάσει:    Grouplist -->
<!--με:                 userid= * -->
<!--                    groupid= * -->

            <dirscript>
            <action type="list">
                <group>
                    <groupid>hod1</groupid>
                    <description>Χρήστες του HOD</description>
                    <parent></parent>
                </group>
                <group>
                    <groupid>group2</groupid>
                    <description>Άλλοι χρήστες</description>
                    <parent></parent>
                </group>
            </action>
            </dirscript>