Fitzgerald & Long Sentry, User Manual

Page: 106 / 113

Appendix 1 - 4 SENTRY User’s Guide
Fitzgerald & Long
ERROR.TEXT = “”””
CALL @SENTRY.USER.ITEM.CONTROL(USER.ITEM, ITEM. FOUND,
ACCESS.RIGHTS, ERROR.TEXT)
Parameters:
USER.ITEM
(Input)
This is the name of the item that was defined with the SENTRY User Item Maintenance screen.
ITEM.FOUND
(Output)
The item requested is searched for in two steps.
STEP 1:
The SENTRY.USER.ITEMS file is searched in the current account for the item. If the
local SENTRY.USER.ITEMS file cannot be accessed or the item is not found, the
subroutine will then continue with step 2.
STEP 2:
The SENTRY.USER.ITEMS file in the SENTRY account is searched for the item. A file
pointer in the local VOC should be called SENTRY.GLOBAL.USER.ITEMS. It should
look like this:
F
sentry/SENTRY.USER.ITEMS
sentry/D_SENTRY.USER.ITEMS
Where “sentry” is replaced by the absolute pathname to the “sentry” directory. On our machine, the path is
/usr/sentry/SENTRY.USER.ITEMS.
If the item is found in either step 1 or 2, the value will be 1. If the SENTRY.USER.ITEMS file in the
SENTRY account cannot be accessed or the item is not found in either step 1 or step 2, the value returned
will be 0.
ACCESS.RIGHTS (Output)
If the user item was found, the current user’s rights to the item are returned.
ERROR.TEXT
(Output)