c_get_multiple_outs - Returns the host filenames and the count of the output images

SYNTAX

#include "las.h"
#include "util.h"
#include "alias.h"
#include "labserv.h"
int c_get_multiple_outs
(
     struct PARBLK      *vblock,
     int                max_num_of_outs,
     char               *param,
     char               hosout[][CMLEN],
     int                *number_of_outs
)

PARAMETERS

vblock (input, PARBLK)

TAE parameter block passed by reference.

max_num_of_outs (input, int)

Maximum number of output files that can be retrieved. It is also the size of the hosout array.

param (input, character, length (*))

Defines the parameter name in the proc which contains the output image specification. In most cases the value of this parameter is OUT.

hosout (output, character, length (max_num_of_outs)(CMLEN))

A two-dimensional array which contains the host names of the output images specified in parameter param.

number_of_outs (output, int)

The total count of output files that were specified in parameter param.

DESCRIPTION

The c_get_multiple_outs() routine is used to return the host filenames of the output image specification. It checks to make sure the files do not exist. E_FAIL is returned if an image file already exists on disk.

RETURN VALUE

c_get_multiple_outs() returns

     E_SUCC (0)  --> successful completion
     E_FAIL (-1) --> operation failed

The routine c_getout() is a similar routine which returns the output images in host and TAE syntax. However, it does not return the count of output files.