Previous Topic: &RETURN

Next Topic: &SECCALL


&RSCCHECK

Returns a value indicating a user's access to resources within a specified resource group.

&RSCCHECK resource-group resource [ resource .... resource ]

&RSCCHECK is a built-in function and must be used to the right of an assignment statement.

The resource validation facility provides a means of controlling access to installation-defined resource groups from an NCL procedure.

If the specified resource is found within the user's scope, a value of YES is returned in the variable specified to the left of the assignment statement.

Multiple resources within a single resource group may be tested in a single statement. When multiple resources are tested, the user must be authorized for all the resources specified. If the user is not authorized for one or more of the resources, a NO value is returned.

Operands:

resource-group

The name for the resource group containing the resources for testing. The resource-group is a mandatory operand (resource groups are defined in the Resource List member specified in the user's UAMS record).

resource .... resource

The name for the resource to be tested. This is qualified by a network name for network resources, or by a resource qualifier if this is present in the resource group member definition control statement.

If the resource name can contain a period (.), and no qualifier is needed, then use a leading period in the value to indicate that there is no qualifier.

Examples: &RSCCHECK

&AUTH = &RSCCHECK $NMMSG NETA.NODE1 
&IF &AUTH = NO &THEN +
    &ENDAFTER &WRITE DATA=NOT AUTHORIZED
&AUTH = &RSCCHECK USERGRP resourcea resourceb resourcec

Notes:

The maximum length for a resource is an optional 8-character qualifier, followed by a period (.), followed by a 64-character resource name.

If no RESOURCE LIST member is specified in the user ID record, then &RSCCHECK returns YES.

&RSCCHECK $NMMSG resource replaces &NFPMCHK resource.

&RSCCHECK $NMCMD resource replaces &NFPVCHK resource.

&RSCCHECK $NMCMDD resource replaces &NFPDCHK resource.

More information:

&NPFxCHK