gtpc2m0uC/C++ Language Support User's Guide

cinfc_fast_ss-Fast Control Program Interface for Any Active Subsystem

This function allows ECB-controlled programs to quickly access protected main storage by returning a pointer to an interface point at execution time. This function can access interface points for any active subsystem.

Format

#include   <c$cinfc.h>
void         *cinfc_fast_ss(int tag, int ssindex);

tag
This parameter is the symbolic label of the interface point.

ssindex
This parameter is the subsystem index.
Note:
Only bits 24-31 of the ssindex are used. If the subsystem is not valid, results are indeterminate.

Normal Return

Pointer to interface address.

Error Return

Not applicable.

Programming Considerations

Examples

The following example returns the address of a field in the subsystem where the ECB is running and does not change the protect key.

#include <c$cinfc.h>
#include <c$eb0eb.h>

  ·
  ·
  ·
char *field_ptr;
  ·
  ·
  ·
field_ptr = (char *)cinfc_fast_ss(CINFC_CMMOPS, ecbptr()->ce1dbi);
  ·
  ·
  ·

Related Information