Entry Point Subroutine Names
Each user exit has an associated entry point name that you use in your
subroutine. You write the code for the entry point subroutine using the
specified name. For example, if you decide to use the create part user
exit, the associated entry point name is ufcre. The entry point name is
the Fortran subroutine name or the C function name that you use in your
program. The parameter list is different for Fortran and C because of string
passing requirements between the two languages. All of the entry point
subroutine names take the same number of parameters.
NOTE: The subroutine ufusr uses a different parameter list when
it is used as a user exit as opposed to an internal Open C API routine.
The parameter lists for all user exit entry points use two parameters for
Fortran routines and three parameters for C routines. We use the generic
name entry_point to show the parameter list. The actual entry point names
are given in the table for UNIX user exits (see table
).
User Exit FORTRAN:
ENTRY_POINT(PARAM, RETCODE)
CHARACTER*132 PARAM
INTEGER RETCODE
NOTE: The two parameters PARAM and RETCODE are outputs.
User Exit C:
void entry_point(char *param, int *retcode, int rlen)
NOTE: The two parameters PARAM and RETCODE are outputs.
The third parameter rlen is declared only. Do not give rlen any
value assignment. NX takes care of rlen for you.
Consider the following code.
void ufcre(param,retcode,rlen)
char *param;
int *retcode,rlen;
{
memset(param, ' ', 132);
memcpy(param, "mypart", 6);
*retcode = 2;
}