SAS/CONNECT User's Guide

Examples

These steps show development of a program that uses the ADMIN procedure.

Start a PROC ADMIN Execution.
```
 PROC ADMIN ID='tcp//host/service';
```

Define Queue Attributes.

Define two queues in a single collection named TEST. The first queue, EXAMPLE1, will contain the following attributes:

nonpersistent messages
maximum depth of 20
maximum message length of 2k.

The second queue, EXAMPLE2, will contain the following attributes:

persistent messages
unlimited depth
unlimited message length
user privileges (USER1 can DELIVER, FETCH, and BROWSE messages, and everyone else can only DELIVER and BROWSE messages).

SET C test;

DEF Q (example1)
   MAXDEPTH(20)
   MAXMSGL(2048);

DEF Q (example2)
   MSGPSIST(yes)
   PRIVILEGES(user1=d+f+b anonymous=d+b);

Display all queues in the TEST collection.

DIS Q (*);

Output from the DISPLAY command.

    -----------------------------------------
    Queue:           EXAMPLE1
    Collection:      TEST
    Creation Time:   13FEB97:10:34:51
    Status:          Inactive
    Type:            Permanent
    Definition:      Administrator Predefined
    Msg Persistence: No
    Delivery Mode:   Default
    Depth:           0
    MaxDepth:        20
    MaxMsgl:         2048
    User Access Rights:
       None defined
    -----------------------------------------
    Queue:           EXAMPLE2
    Collection:      TEST
    Creation Time:   13FEB97:10:35:36
    Status:          Inactive
    Type:            Permanent
    Definition:      Administrator Predefined
    Msg Persistence: Yes
    Delivery Mode:   Default
    Depth:           0
    MaxDepth:        -1
    MaxMsgl:         -1
    User Access Rights:
        USER1 = Deliver+Fetch+Browse
        ANONYMOUS = Deliver+Browse
    -----------------------------------------

Quiesce the DOMAIN Server.
Quiesce the DOMAIN server for gradual termination.
```
Q;
```
Quit PROC ADMIN.
Quit the procedure.
```
QUIT;
```

This example shows the use of the ADMIN procedure to obtain agent information. Specifically, it displays information about the agent PAYROLL that exists in any collection.

SET AGENT PAYROLL;

DIS A (C*);

    -----------------------------------------

    Agent:                  PAYROLL
    Collection:             MONTHLY
    Owner:                  sasuser4
    Current Scheduled Date  26MAR1998
    Current Scheduled Time  23:59:00
    Description:            Payroll agent used 
                            for montly processing.
    Run Location:           tcp//host1/shr7
    Completion Queue:       CARY
    Schedule Definition:
       Run Hour             23
       Run Minute           59
       Run Day-of-Week       5
    -----------------------------------------

Chapter Contents
Previous
Next
Top of Page