HP 3000 Manuals HP 3000 Manuals
GETRIN
Acquires a global resource identification number (RIN) and assigns a
password to it.
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 Notes
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 rejects your
request and issues 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.
Use
This command may be issued from a session, job, program, or in BREAK.
Pressing Break has no effect on this command.
Example
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
Related Information
Commands FREERIN
Manuals Resource Management Programmer's Guide (32650-60011)