gtpc2m63C/C++ Language Support User's Guide

rvtcc-Search Resource Vector Table (RVT) Entries

This function searches the RVT for the next entry that matches the search criteria specified in the input arguments.

Format

#include     <sysapi.h>
struct rvtcc_return *rvtcc(enum rvtcc_step step, enum rvtcc_arg arg,
                           const void *rvt1, const void *rvt2,
                           struct rvtcc_return *rvt_s);

step
One of the following step types:

RVTCC_NEXT
Returns the next resource in the resource vector table (RVT)

RVTCC_PREV
Returns the previous resource in the RVT.

arg
One of the following search types:

RVTCC_CCW
When step=RVTCC_NEXT, the RVT entry for the next resource with a session using the ALS/NCP/CTC is returned. When step=RVTCC_PREV, the RVT entry for the ALS/NCP/CTC is returned.

RVTCC_CDRM
When step=RVTCC_NEXT, the RVT entry for the next resource owned by the CDRM is returned. When step=RVTCC_PREV, the RVT entry for the CDRM is returned.

RVTCC_LOCAL
When step=RVTCC_NEXT, the RVT entry for the next local resource is returned. When step=RVTCC_PREV, the entry for the local system services control point (SSCP) is returned if the input entry is not a secondary logical unit (SLU) thread. If the input entry is an SLU thread, the entry for the application primary logical unit (PLU) is returned.

RVTCC_NONE
When step=RVTCC_NEXT, the RVT entry for the next resource in collating sequence is returned. When step=RVTCC_PREV, the entry for the previous resource in collating sequence is returned.

rvt1
A pointer to a resource vector table part 1 (RVT1) or session control block part 1 (SCB1) entry that uniquely identifies an SNA resource or a NULL pointer.

rvt2
A pointer to a resource vector table part 2 (RVT2) or session control block part 2 (SCB2) entry that uniquely identifies an SNA resource or a NULL pointer.

rvt_s
A pointer to storage allocated for the structure rvtcc_return.

Normal Return

Pointer to a structure of type rvtcc_return, which is defined in sysapi.h.

Error Return

NULL pointer.

Programming Considerations

Either the rvt1 or rvt2 input argument must contain a valid entry address. The other argument must be NULL. If both arguments are not NULL, the rvt1 argument is used. No error checking is performed to verify that both pointers are consistent.

Examples

The following example locates the next resource owned by a specific CDRM.

#include <sysapi.h>

  ·
  ·
  ·
void *rvt1_address; struct rvtcc_return &rvtcc_list, *rvtcc_parm=&rvtcc_list;
  ·
  ·
  ·
rvtcc_parm = rvtcc_return (RVTCC_NEXT, RVTCC_CDRM, rvt1_address, NULL, rvtcc_list);

Related Information

None.