gtpc2m63 | C/C++ Language Support User's Guide |
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.