
{OSH$RESERVE_KEYPOINT_ENV
{
{  This procedure is responsible for reserving the keypoint collection
{  environment
{for a job. The parameters for this procedure are:
{
{ ENVIRONMENT: (INPUT)           This parameter specifies the environment in
{ which
{                                keypoints will be collected. The
{                                possibilities are
{                                job, system, system_sample, or job_sample. The
{                                default environment is job.
{
{ MONITOR_MASK: (INPUT)          This parameter specifies what class(es) of
{                                keypoints are to be collected during monitor
{                                mode execution.
{
{ JOB_MASK: (INPUT)              This parameter specifies what class(es) of
{                                keypoints are to be collected during job
{                                mode execution.
{
{ COLLECTION_FILE: (INPUT)       This parameter specifies a permanent file
{                                name for each processor on which keypoints
{                                are to be collected.
{
{ WAIT: (INPUT)                  This parameter specifies whether the command
{                                should wait indefinitely for the keypoint
{                                environment.
{
{ MULTI_PROC_OPTION: (INPUT)     This parameter specifies if the job should
{                                be configured to allow its tasks to run on
{                                one or all processors of a mainframe.
{
{ KEYPOINT_COUNT: (INPUT)        This parameter specifies the maximum number of
{                                keypoints to be collected.
{
{ KEYPOINT_BUFFER_SIZE: (INPUT)  This parameter specifies the maximum amount
{                                of keypoint buffer space to be allocated
{                                in real memory.
{
{ DATA_STRING: (INPUT)           This parameter specifies a string (maximum
{                                32 characters) to be placed into the
{                                keypoint file.
{
{ STATUS: (OUTPUT)               This parameter returns the status of the
{                                procedure.
