GETRIN


GETRIN

     Acquires a global resource identification number (RIN) and
assigns a password to it. (CM)

SYNTAX

     GETRIN rinpassword


PARAMETERS

rinpassword         Password of the intrinsic that locks the RIN.  The
password must contain from one to eight alphanumeric
characters, beginning with an alphabetic character.

OPERATION

     The GETRIN command acquires a global RIN from the MPE/iX
RIN pool, typically during a session. You must assign an
arbitrary password for the RIN, which aids in restricting
its use to authorized users. You can then give this RIN and
the associated password to cooperating users so that it can
be locked and unlocked by them. For instructions on how to
lock and unlock a RIN, and how to pass a RIN and its
password as intrinsic parameters, refer to the MPE/iX
Intrinsics Reference Manual (32650-90028).

Users who know the RIN and its password can use it in their
programs (in jobs or sessions) until the user who acquired
the RIN releases it with the FREERIN command. The RIN
acquired is always a unique, positive integer. The total
number of RINs MPE/iX can allocate is specified when the
system is configured, but cannot exceed 1024. If all
currently available RINs have been acquired by other users,
MPE/iX will reject your request and issue the message

RIN TABLE FULL

In this case, you must wait until one of the RINs becomes
available, or request that your system manager raise the
maximum number of RINs that can be assigned.

This command may be issued from a session, job, program, or
in BREAK. Pressing [Break] has no effect on this command.


EXAMPLE(S)

     To acquire a global RIN and assign to it the password MYRIN, enter

GETRIN MYRIN

MPE/iX responds with the RIN number assigned, for example

RIN 1

ADDITIONAL INFORMATION

Commands:   None

Manuals : Resource Management Programmer's Guide (32650-60011)