HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

FDEVICECONTROL

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

NM and CM callable.

Provides control operations to a printer, terminal, or a spooled device file and is used to:

  • Download character sets, forms, and internal or control tables used in printing.

  • Control the page size, pen positioning, form and use of character sets, the number of copies to be printed, and all other printing environment characteristics.

  • Perform control operations on a terminal, printer, or spooled device file.

Syntax

                I16V    UDS   I16V    I16V

   FDEVICECONTROL(filenum,buffer,length,controlcode

                U16V   U16V    U16

                parm1,parm2,fserrorcode);

Parameters

filenum

16-bit signed integer by value (required)

Passes the file number of the device file.

buffer

user-defined structure (required)

Passes and returns device information:

  • Passes information to the device, such as character sets, forms, vertical format control (VFC) information, or device control actions.

  • Returns device driver information.

(ASC) The buffer is usually a 16-bit integer by reference or, for controlcode=192, where parm=1, buffer is a character array containing the name of the terminal type or printer type file. For controlcode=192, buffer values are defined in the parm1 discussion.

length

16-bit signed integer by value (required)

Passes the length of buffer:

  • If positive, it indicates the length in half words.

  • If negative, it indicates the length in bytes.

(ASC) If controlcode=192, length is normally set to 1 unless parm1 is set to 1 (specifying a new terminal or printer type file), then the length of the array is specified in the length parameter.

controlcode

16-bit signed integer by value (required)

Passes the item value to be returned. (Refer to Table 4-4 “FDEVICECONTROL Controlcode/Parm1,Parm2 Values”.)

(ASC) Passes the number of the operation to be performed. Controlcode 192 is used to apply control directives to a device file.

Codes 0 through 64 call FCONTROL. Control passes to FCONTROL, and any errors returned will have originated with FCONTROL.

parm1, parm2

16-bit unsigned integer by value (required)

Passes the value specified in the corresponding controlcode; there are several values for parm1 and parm2 that define the operation in more detail. (Refer to Table 4-4 “FDEVICECONTROL Controlcode/Parm1,Parm2 Values”.)

fserrorcode

16-bit unsigned integer by reference (required)

Returns a file system error code number if an error occurs. If no error occurs, fserrorcode is set to zero. If FDEVICECONTROL detects a bounds violation for fserrorcode (that is, an address outside your stack area), fserrorcode is returned unchanged.

Table 4-4 FDEVICECONTROL Controlcode/Parm1,Parm2 Values

Control- codeMnemonicParm1,Parm2 Description
128I16V

Character set selection:

parm1 (8:8)

Primary character set identification

parm2 (8:8)

Secondary character set identification

The Hewlett-Packard 268x page printer can contain up to 32 character sets, allowing the use of a variety of fonts, styles, print rotations, and languages. Controlcode=134 is used to download character sets to the printer or to select any two downloaded character sets to be the current primary and secondary character sets.

To change to the secondary character set (one character at a time), set the eighth bit of the byte coding for the desired ASCII character. The Hewlett-Packard 268x strips out this bit and prints (in the secondary character set) the character represented by the remaining 7-bit value. To change to the secondary character set for a number of characters and over several lines, insert a CTRLN (shift-in character) in the data. Insert a CTRLO (shift-out character) where the primary character set is to be reactivated.

129I16V

Logical page activation/deactivation request:

parm1 (0:1)

0 = Ignore the left byte of parm2. 1 = Deactivate the logical page table entry identified in the left byte of parm2.

parm1 (1:1)

0 = Ignore the right byte of parm2. 1 = Activate the logical page table entry identified in the right byte of parm2.

parm2 (0:8)

Logical page table entry (0 to 31) to be deactivated. Ignored if parm1 (0:1)=0.

parm2 (0:8)

Logical page table entry (0 to 31) to be activated. Ignored if parm1 (1:1)=0.

Logical pages being printed can be canceled or enabled through the activation or deactivation of those pages.

Every physical page is composed of one or more logical pages. When the Hewlett-Packard 268x begins to print each physical page, it scans the logical page table (LPT) for the first logical page labeled as ACTIVE. The printer then continues searching the table sequentially for active pages and printing them until it has printed the last active page. At this point, the Hewlett-Packard 268x performs a physical page eject and starts the sequence again. There must be at least one active LPT entry while the Hewlett-Packard 268x is printing.

130I16V

Relative pen displacement:

parm1

A 16-bit signed integer containing the desired X-axis displacement, in dots, of the pen from its current position.

parm2

A 16-bit signed integer containing the desired Y-axis displacement, in dots, of the pen from its current position.

No pen movement results from requests to move the pen off the logical page. Because the coordinate system is based upon the current logical page itself and not upon the page's orientation with respect to the printer, do not consider how the page has been rotated when assigning displacement values to parm1 and parm2. Since the dot density for the Hewlett-Packard 2680 (180 dots per inch) differs from the Hewlett-Packard 2688 (300 dots per inch), the effects of parm1 and parm2 are different.

131I16V

Absolute pen move:

parm1

An integer containing the X-coordinate, in dots, of the point to move the pen.

parm2

An integer containing the Y-coordinate, in dots, of the point to move the pen.

The values in parm1 and parm2 are measured from the upper left corner of the logical page. Do not take page rotation into account when assigning coordinates as the printer does not move the pen if the location specified is off the logical page. Since the dot density for the Hewlett-Packard 2680 (180 dots per inch) differs from the Hewlett-Packard 2688 (300 dots per inch), the effects of parm1 and parm2 are different.

132I16V

Define job characteristics:

parm1 (0:1)

0 = Ignored 1 = Printer does not print job separation marks until next open job

parm1 (1:1)

0 = Ignored 1 = Parm2 contains maximum allowable number of copies

parm2

Significant only if parm1 (1:1)=1 (Specifies the maximum number of copies the printer makes, for any one page, for the current job. The default maximum is 32,767.)

133I16V

Define physical page.

The following bits are ignored if set to zero:

parm1 (0:1)

1 = Multicopy form overlay feature on

parm1 (1:1)

1 = Multicopy form overlay feature off

parm1 (2:1)

1 = Reserved for the operating system

parm1 (3:1)

1 = Redefine physical page length

parm1 (4:1)

1 = Redefine number of copies per page

parm1 (5:1)

1 = Reserved for the operating system

parm1 (6:1)

1 = Reserved for the operating system

parm1 (7:1)

1 = Reserved for the operating system

parm1 (8:8)

New physical page length in units of 0.25 inches; cannot be less than 3.0 inches (a value of 12) or greater than 17.0 inches (a value of 68)

parm2

Number of copies to print; if number exceeds the maximum defined in parm2 of controlcode 132, only the maximum number of copies is printed

FDEVICECONTROL accepts page length values that are in multiples of 0.25 inches, but the Hewlett-Packard 268x printer is able to produce only pages that are multiples of 0.5 inches. For this reason, use only even values in parm1 (8:8) (bit (15:1)=0).

134I16V

Download/delete character set:

parm1 (0:1)

0 = Download character set identified in right-hand byte of parm2, Hewlett-Packard 268x 1 = Purge character set identified in right-hand byte of parm2, Hewlett-Packard 268x

parm2 (0:1)

0 = First record of a load 1 = Continuation of previous record

parm2 (8:8)

Character set identifier; integer from 0 to 31

If there is an attempt to download a character set having the same identifier as one existing in the printer, then the Hewlett-Packard 268x purges the existing character set and repacks the user area before loading the new font. However, before the modification of the user area, the Hewlett- Packard 268x prints all data currently in its buffer, as it does when a character set, form, or vertical format control set (VFC) is loaded, overlayed, or deleted.

135I16V

Download/delete form:

parm1 (0:1)

0 = Load form set identified in the right-hand byte of parm2

1 = Purge identified form set from the Hewlett-Packard 268x printer's memory

parm2 (0:1)

0 = First record of a load

1 = Continuation of previous record

parm2 (8:8)

Form set identifier; integer from 0 to 31

If attempting to download a form set having the same identifier as one existing in the printer, then the Hewlett-Packard 268x purges the existing form set and repacks the user area before loading the new form. However, before the modification of the user area, the Hewlett-Packard 268x prints all data currently in its buffer, as it does whenever you load, overlay, or delete a character set, form, or vertical format control set (VFC).

136I16V

Download logical page table:

parm1

Not used

parm2 (0:1)

0 = First record of a load

1 = Continuation of previous record

A logical page is a page of data that may take up an entire sheet of paper. It is possible to print up to eight logical pages on one physical page. The logical page table, 513 words long, contains some of the information needed to print up to 32 logical pages, so that the set of up to eight logical pages printed on any one physical page can be varied.

137I16V

Download multicopy form overlay table:

parm1

Not used

parm2

Not used

Prints up to eight copies of a page, each on one or two different forms. FDEVICECONTROL downloads into the printer's memory a table containing one word of information for each of the eight possible copies to be overlaid with a form. The format of each word of the table is:

Bit (0:1)

0 = Ignored

1 = Overlay form1 on physical page

Bit (1:1)

0 = Ignored

1 = Overlay form2 on physical page

Bits (2:4)

Reserved for the operating system

Bits (6:5)

Form1 identifier; integer from 0 to 31

Bits (11:5)

Form2 identifier; integer from 0 to 31

138I16V

Download/delete vertical format control (VFC);

parm1 (0:1)

0 = Load VFC

1 = Delete VFC

parm2 (0:1)

0 = First record of a load

1 = Logical continuation of the previous record

parm2 (8:8)

VFC set identifier; integer from 0 to 31

The VFC table is an ASCII file downloaded to the Hewlett-Packard 268x printer in order to give specific instructions on the print density, location of the top of the page, the bottom of the page, and other specifications of the printed page.

The Hewlett-Packard 268x expresses the height of a printed line in dots and the system uses this value to compute line positions on the page. Because these space measurements are relative to the top of the logical page, as opposed to the physical page, use the same or different VFC tables for logical pages of different rotations.

139I16V

Download/delete a picture:

parm1 (0:1)

0 = Load picture

1 = Delete picture

parm2 (0:1)

0 = First record of a load

1 = Logical continuation of the previous record

parm2 (8:8)

Picture identifier; integer from 0 to 31

When the picture is downloaded to the Hewlett-Packard 268x, it changes every pointer to reflect where the dot per bit symbol actually is in memory. If a picture is downloaded and one is already present with the same identifier (0-31), then the original one is overwritten in the picture descriptor block (PDB). The area taken up by the deleted picture is freed as soon as the page has been transferred to paper.

140I16V

Page control:

parm1 (15:1)

0 = Do not eject physical page

1 = Eject physical page before going to logical page (no effect if the first record since an environment load, FOPEN/FCLOSE)

parm1 (13:2)

Auto-eject mode:

00 = Use auto-eject flag of last data record (default at start; auto-eject enabled)

01 = Enable auto-eject (select VFC channel 1 on new page)

11 = Disable auto-eject (position pen at top of page)

parm2 (8:8)

Logical page number; integer from 0 to 31

The logical page identified in parm2 becomes the current logical page even if other logical pages have entries that precede it in the logical page table. FDEVICECONTROL activates the specified page if it is inactive, and the Hewlett-Packard 268x performs a physical page eject if parm1 (15:1)=1.

141I16V

Clear environment:

When set to zero, the following bits are ignored.

parm1 (0:1)

1 = Clear all character sets

parm1 (1:1)

1 = Clear all forms

parm1 (2:1)

1 = Clear all vertical format controls (VFCs)

parm1 (3:1)

1 = Clear all pictures

parm2

Not used

The printer flushes all data currently in its buffers and then performs the indicated clears, if any.

142I16VReserved for the operating system
143I16V

Load default environment:

parm1

Not used

parm2

Not used

The Hewlett-Packard 268x printer flushes all data, erases the user area, and loads the default character set, the vertical format control (VFC), and the logical page table (LPT).

144I16V

Print picture:

parm1 (0:1)

0 = Temporary picture

1 = Addressable picture

parm1 (1:1)

0 = X and Y relative to the current pen position

1 = X and Y are absolute pen position to the logical page

parm1 (2:14)

X coordinate for picture placement (radixed integer)

parm2 (0:1)

0 = First temporary picture load

1 = Continuation record for load

parm2 (1:1)

Not used

145I16V

End of job:

parm1

Not used

parm2

Not used

146I16V

Device extended capability mode:

parm1

0 = Clear

1 = Set

parm2

Not used

148I16V

Device Status:

Enable, disable, or return various types of extended device status. In order to maintain backward compatibility with MPE V/E, the initial setting (after first FOPEN of device) is set to disable all status reporting. Any application that requires status reporting must enable status reporting after opening the device.

Status reporting is a global device feature, either every accessor sees it or does not see it.

When enabled, device related I/O errors (if they occur) are not returned. The caller is notified that the device has status and another FDEVICECONTROL call has to be made to determine the status.

When enabling status, the buffer returns the number of bytes occupied by the largest status block returned by the device. This number is returned in a 32-bit integer, and the count must be set to at least 4 bytes; otherwise, a bounds violation occurs.

When nowait I/O is enabled, FWRITE does not notify the caller that status is available. The application is notified that the status is available after calling IOWAIT or IODONTWAIT.

The status return can be either a wildcard (return any available status) or a specific type:

param1

0

Any available and enabled status

1

Device status

2

Environment status

3

Job status

4

Job error log status

parm2

0

Return last buffered status

1

Return new actual status

2

Enable status specified in param1

3

Disable status specified in param1

149I16V

Set data block number:

To be used for printer error recovery. The data block number is used as the printing application/utility data index. The printing application can set data block numbers allowing it to return to that place in the data stream and retransmit data from that point forward.

parm1

Lower half of the 32-bit integer

parm2

Upper half of the 32-bit integer

150I16V

Start silent run:

Used to start printer recovery from specific error conditions on recoverable devices or to backup or skip forward a specified number of pages and resume printing.

parm1

Start silent run physical page number

parm2

Resume printing of physical page number

151I16V

Print standard header or trailer:

Used to print standard headers/trailers. If headers/trailers are disabled through the BANNERS, HEADON, or HEADOFF commands, this control code is invalid.

PM (privileged mode) is required to use this option.

The file system does not perform printer setup/reset functions before or after printing the banner; therefore, the caller must place the printer and paper in the proper state before and after calling this control code.

parm1

0

Print standard header

1

Print standard trailer

parm2

Not used, must be set to zero

192U16V

Perform control functions on terminal device files:

parm1

Indicates the specific control directive applied to the terminal device file being accessed. For printers, only parm1=1 is supported. Valid values are:

1

Specify terminal type or printer type file:

Specifies a new terminal type or printer type file for use with a device. The specified file may be created through the TTUTIL utility. The name of the terminal type or printer type file is passed in buffer, with the length of buffer set through the length parameter. If this call is issued against a device connected through PAD, CCE (2) is returned and the terminal or printer type associated with the device is changed, but the device operates as if no device control action took place.

2

Set read timeout value for next read:

Sets a timeout value to be applied to the next read request in seconds. If the timer expires before the next read is terminated, the read data is transferred to the buffer and the read reply returns a software timeout error status with length=0. For reads posted to devices connected through PAD, add enough time to compensate for delays caused by the network.

3

Set line speed for the device:

Set the line speed for the device associated with filenum by entering a new line speed, representing characters per second, as the value of buffer. Supported speeds are 30, 120, 240, 480, 960, and 1920 characters per second. Input and output line speeds are the same. If this call is issued against a device connected through PAD, the terminal control action is ignored and a meaningless value is returned.

4

Set echo ON/OFF at terminal:

Enable or disable read data echo to a terminal through the DTC. Valid values are:

0

Echo off

1

Echo on

This call is not valid if the terminal is operating in binary or block mode.

5

Set system break response on or off at a terminal:

Enable or disable system response to the entry of a system BREAK at the terminal. Valid values are:

0

Disable break

1

Enable break

6

Set subsystem break response on or off at a terminal:

Enable or disable system response to the entry of a subsystem break character at the terminal. Valid values are:

0

Disable subsystem break

1

Enable subsystem break

If the terminal is connected through PAD, the subsystem break must be followed by a RETURN to signal PAD that data is to be forwarded.

8

Obtain time used for completion of last read:

Determine the time, in seconds, required for the last read to complete. Ensure that this call is placed immediately after the read to be timed, with no subsequent reads in between. Only read access is allowed for this request. All reads are timed, so there is no need to enable the timer.

9,11

Set parity generation and checking on or off:

Enable or disable parity generation and checking between the driver and device. Valid values are:

0

Disable parity; all eight bits of each character are passed through.

1

Enable parity; type of parity specified by the parity setting is in effect.

Input and output parity is the same. If issued for a terminal connected through PAD, CCE (2) is returned, but no terminal control action occurs.

10, 12

Set type of parity:

If parity is enabled, this request determines what kind of parity is computed when parity is checked:

0

No parity check on input, eighth bit set to 0 on output (parity type = zeros)

1

No parity check on input, eighth bit set to 1 on output (parity type = ones)

2

Even parity checked on input, even parity generated on output (parity type = even)

3

Odd parity checked on input, odd parity generated on output (parity type = odd)

If parity is disabled, no parity is used.

If issued for a terminal connected through PAD, CCE (2) is returned, but no terminal control action occurs.

14

Set line deletion response:

Enables or disables the transmission of line deletion characters (!!!) to the terminal after a user cancels a line at a terminal:

0

Disable transmission

1

Enable transmission

Line deletion characters are not output by PAD devices. If issued to a terminal connected through PAD, CCE (2) is returned, but no terminal control action occurs.

15

Set transparent editing mode:

Enables or disables transparent (unedited) mode. When enabled, allows most special characters to be read and treated as data and a small subset to retain their meaning:

AEOR

The AEOR character defined through a previous call to FCONTROL itemnum=25. The read terminates in error, and a call to FCHECK returns an error code of 31. The AEOR character is passed with the data and included in the byte count.

BREAK

Causes a system break (when enabled) and transfers control to the system. If the RESUME command is entered, transparent editing is resumed.

CTRLQ (DC1 or XON)

The resume output character of the XON/XOFF handshake. This character is stripped from the input data when XON/XOFF protocol is enabled.

DC2

When input as the first character, it is stripped out. A DC1 (CTRLQ) is written to the terminal. If not input as the first character, DC2 is a data character.

CTRLS (DC3 or XOFF)

The stop output character of the XON/XOFF handshake. This character is stripped from the input data when XON/XOFF protocol is enabled.

Enable transparent editing by passing non-NUL characters for the subsystem break and EOR characters in the buffer in the following format:

bits (0:8)

Specifies the character to be used as the subsystem break character. Any character not defined as a special character in transparent mode (including the standard subsystem break character) can be used. If set to 0, subsystem break is disabled.

bits (8:8)

Specifies the character to be used as the line termination character (EOR). Any character not defined as a special character in transparent mode can be used.

Disable transparent editing by passing NUL characters.

If used for a device connected through PAD, data is not forwarded from the terminal immediately after the characters defined as the subsystem break or EOR character are typed. The terminal user has to press RETURN to cause data to be transmitted, or wait for the data forwarding timer to expire (if set). The host software recognizes and acts on the characters defined in this call.

26

Device XON/XOFF:

Enable or disable XON/XOFF flow control between the device and the DTC:

1

Enable device XON/XOFF

0

Disable device XON/XOFF

When enabled, the DTC stops sending data to the device when XOFF is received and resume when XON is received. XON/XOFF characters are not sent to the host.

When disabled, the XON/XOFF characters are not treated as control characters, but are passed to the host as data. When disabled, data overruns can occur.

27

Set XOFF timer value:

Enable or disable the XOFF timer.

To enable the XOFF timer, pass a positive value, representing time in seconds, in the buffer parameter. The XOFF timer causes a warning message to be sent to the console if a device is XOFFed for a time exceeding the set limit.

To disable the XOFF timer, pass a 0 or negative value in the buffer parameter.

If issued to a terminal connected through PAD, CCE (2) is returned, but no terminal control action occurs.

28

Block mode types supported:

This is a read only request that returns a value representing the type of block mode supported by the driver. Valid values are:

6

DTC style page block mode

7

Line and DTC style page block mode

15

PAD terminal supporting page block mode

29

Block mode alert character:

Specifies the character used to signal Hewlett-Packard block mode transfers. The standard alert character is DC2. This call only defines the alert character; it does not enable Hewlett-Packard block mode.

If issued to a terminal connected through PAD, CCE (2) is returned, but the device control action does not occur.

30, 32

Read trigger and block mode trigger character:

Specify which character the DTC should send to trigger a character mode or block mode read on a device. The standard trigger character is DC1. If a NUL character is specified, there is no trigger character.

If issued to a terminal connected through PAD, CCE (2) is returned but the device control action does not occur.

36

Backspace character:

Specifies which character will be a backspace in standard editing mode.

Default: backspace

37

Cancel line character

Specifies which character will be a line deletion character in standard editing mode.

Default: CTRLX

39

Type 1 EOR character:

Specifies the EOR character to be used in standard or transparent editing mode. This value is passed in the high order byte (value * 256) of buffer. If issued to a terminal connected through a PAD, the new EOR character (non-carriage return) must be followed by a carriage return to instruct the PAD to transmit the data. Use a null character to disable the character.

Default: Return

40

Type 2 EOR character (AEOR):

Specifies the AEOR character and enables its use. This value is passed in the high order byte (value * 256) of buffer. Any character can be specified, but do not use any special characters (refer to FCONTROL itemnum=25 for details). If issued to a terminal connected through a PAD, the new EOR character (non-carriage return) must be followed by a carriage return to instruct the PAD to transmit the data. Use a null character to disable the AEOR character.

41

Subsystem break character:

Specifies the character is to be used as the subsystem break character. This value is passed in the high order byte (value * 256) of buffer.

If issued to a terminal connected through PAD, the new subsystem break character is recognized by the host, but the terminal user has to press RETURN following the subsystem break to signal the PAD that data is ready to be transmitted.

51

Set typeahead mode:

Enable or disable typeahead mode:

0

Disable typeahead mode; accept read data from the device as it is posted. The terminal user must wait for a new read to be posted before entering additional data. (default)

1

Enable typeahead mode; pass read data from the device to a typeahead buffer (up to 224 characters). The terminal user can enter data before a read has been posted. Typeahead is not supported on PAD terminals. If issued for a terminal connected through PAD, CCE (2) is returned, but the device control action does not occur.

52

Form feed in output data:

Specifies whether the form feed character is replaced in the carriage control of terminals:

0

Replace form feeds with a form feed replacement character

1

Form feed allowed

53

Define form feed replacement character:

Specifies the character that replaces the form feed character in the terminal carriage control when form feed replacement is enabled. The form feed in carriage control is replaced; form feed in data is not replaced. A default of NUL is used if form feed replacement is enabled and no replacement character is specified.

55

Backspace response action:

Selects the action the DTC takes when it receives a backspace character. Valid values are:

1

Remove character from input and back cursor up one space (default)

5

Remove character from input and erase character (backspace, space, backspace)

If issued against a terminal connected through PAD, CCE (2) is returned, but the device control action does not occur.

56

Data bits per character:

Specifies whether 7-bits or 8-bits are used for each character.

If 7-bits is selected, parity generation and checking is controlled by the current parity setting. If the current parity is set to "no parity" or parity checking is disabled, parity is not in effect.

If 8-bits is selected, parity is set to "no parity" and the current parity setting is saved, so when the user switches back to 7-bits, parity is returned to its previous setting.

If issued against a terminal connected through PAD, CCE (2) is returned, but the device control action does not occur.

57

Subsystem break character:

Returns the current subsystem break character.

60

Flush typeahead buffer:

Valid values are:

1

Flush the typeahead buffer before the next read is started. Any data in the typeahead buffer is lost. Valid for the next read only.

0

Disable the request.

Flush typeahead is enabled only if typeahead is enabled.

If issued against a terminal connected through PAD, CCE (2) is returned, but the device control action does not occur.

61

Bypass typeahead buffer: Valid values are:

1

The next read is taken from the device, and any information currently in the typeahead buffer is bypassed. The data in the typeahead buffer is not flushed, and can be obtained by a subsequent read. The request is valid for the next read only.

0

Disable the request.

This request is valid only if typeahead is enabled.

If issued against a terminal connected through PAD, CCE (2) is returned, but the device control action does not occur.

62

Quiesce I/O: Valid values are:

1

The control will not complete until all previous I/O to the device has completed. If issued against a terminal connected through a PAD, control issues only previous I/O sent to PAD and not to the device.

63

Single echo mode in typeahead: Valid values are:

1

Enables single echo. Typeahead data will be echoed only when the read is posted.

0

Disable the request. Typeahead data will be echoed when entered and when the read is posted (default mode).

This request is valid only if typeahead is enabled.

If issued against a terminal connected through PAD, CCE (2) is returned, but the device control action does not occur.

64

Ignore parity error on input: Valid values are:

1

Parity errors will be ignored.

0

Parity errors will be reported (default).

If issued against a terminal connected through PAD, CCE (2) is returned, but the device control action does not occur.

parm2

Indicates the read and write access for the operation being performed. Set parm2 to one of the following values:

1

Read only; return current information

2

Write only; pass new information

3

Read/Write; pass new information and return valid information before call

Information is returned in the area pointed to by the buffer parameter. For detailed information, refer to the Asynchronous Serial Communications Programmer's Reference Manual (32022-90002).

193I16V

Record processing information for NRJE spoolfiles:

parm1

Indicates the character code (for example, ASCII) of spoolfile data. Refer to SNA NRJE Network Remote Job Entry User/Programmer Reference Manual (30245-90001).

parm2 (14:1)

0 = Data not compacted 1 = Data compacted

parm2 (15:1)

0 = Data not compressed 1 = Data compressed

 

Table 4-5 FDEVICECONTROL Controlcode 192 Values

Parm1Parm2Description
1R/WSpecify terminal or printer type file
2R/WSet read timeout value for the next read
3R/WSet the line speed for the device
4R/WSet echo ON/OFF at a terminal
5R/WSet system break response ON/OFF at a terminal
6R/WSet subsystem break response ON/OFF at a terminal
8RObtain time used for completion of the last read
9R/WSet parity checking ON/OFF
10R/WSet type of parity to check
11R/WSet parity generation ON/OFF
12R/WSet type of parity generated
14R/WSet line deletion response
15R/WSet transparent editing mode
26R/WDevice XON/XOFF enable
27R/WSet XOFF timer value
28RBlock mode types supported
29R/WDefine block mode alert character
30R/WDefine block mode trigger character
32R/WDefine read trigger character
36R/WDefine backspace character
37R/WDefine cancel line character
39R/WDefine type 1 EOR character
40R/WDefine type 2 EOR character (AEOR)
41R/WDefine subsystem break character
51R/WSet type ahead mode
52R/WForm feed allowed in output data
53R/WDefine form feed replacement character
55R/WSelect backspace response action
56R/WSpecify data bits per character
57RObtain subsystem break character
60R/WFlush typeahead buffer
61R/WBypass typeahead buffer
62WQuiesce I/O
63R/WSingle echo mode typeahead
64R/WIgnore parity error

 

Operation Notes

Not used for KSAM files.

Condition Codes

CCE (2)

Request granted.

CCG (0)

Not returned.

CCL (1)

Request denied. An error occurred.

Related Information

Intrinsics

FCONTROL

Commands

None

Manuals

Accessing Files Programmer's Guide (32650-90017), IFS/3000 Reference (36580-90001), and MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)

Feedback to webmaster