.IDENT - write an ident image for a backdoor file.

Alternate Entry Name: _IDENT

Usage:

B:
   .ident( unit, userid, banner );

C:
   void _ident(FILE *unit, const char *userid,
               const char *banner);

Where:

unit: is the unit number where the ident image is to be written. The unit must be open and set for a print image media code.
userid: is a string giving the first field of the ident image.
banner: is a string giving the second field of the ident image.

Description:

.IDENT writes a $IDENT record onto a file. This must be the first record of a file being passed as a backdoor to SYSOUT, so normally .IDENT will be called immediately after opening "unit".

The $IDENT record is used by SYSOUT to prepare the banner page (first page), which normally contains the userid and a banner chosen by the user. Because of complexities in the $IDENT record format, it is difficult to create this record without using .IDENT.