The Add Extended Wireless Controller PTC Entry (ADDEWCPTCE) command adds a set of Portable Transaction Computer (PTC) group parameters to an extended wireless controller source file member. The PTC group parameters are the configurable PTC 5250 emulation operating parameters. These parameters are sent to each configured PTC at emulation startup. The Add Extended Wireless Controller Member (ADDEWCM) command must be run before this command to create the source file member.

Restriction If the values specified for the INZFILE and INZMBR parameters of this command do not match the values specified for the corresponding parameters of the wireless controller description, extended wireless controller configuration data will not be downloaded to the wireless adapter.

Restriction: To execute this command, the user profile requires *IOSYSCFG special authority.

Note: You can use the Change Controller Description (Local Work Station) (CHGCTLLWS) command to view or change values specified for the INZFILE and INZMBR parameters in the wireless controller description.

Parameters

Keyword	Description	Choices	Notes
PTCGRP	PTC group	Name	Required, Positional 1
INZMBR	Initialization source member	Name	Required, Positional 2
INZFILE	Initialization source file	Qualified object name	Optional, Positional 3
	Qualifier 1: Initialization source file	Name, QEWCSRC
	Qualifier 2: Library	Name, *LIBL
PTCRANGE	PTC ID range	Element list	Optional
	Element 1: Begin ID	0001-1022, 0001
	Element 2: End ID	0001-1022, 1022
INTENSITY	Intensity	*NORMAL, *INVERSE	Optional
STSLINE	Status line	*YES, *NO	Optional
CSRTYPE	Cursor type	*UNDERLINE, *BLOCK	Optional
INACTTMR	Inactivity timer	0-9999, *DEV	Optional
BCKLTTMR	Backlight timer	0-9999, *DEV	Optional
BCKLTKEY	Backlight key	*ON, *OFF	Optional
BYPASSEXIT	Bypass exit	*YES, *NO	Optional
AUTORUN	Automatic run	*YES, *NO	Optional
PRINTER	Printer	*SYSTEM, *PTC	Optional
WANDTYPE	Wand type	*NONE, *PENCIL, *LASER, *RS232	Optional
PECKRATE	Wand pecking rate	*DEV, 2, 4, 8, 16, 32, 48	Optional
LASERTMR	Laser read timer	*DEV, 1440, 2880, 4320, 5760	Optional
BCDFKEY	Barcode function keys	*OFF, *ON	Optional
AUTOENTER	Auto Enter	*OFF, *ON	Optional
CSRLOC	Cursor location	*HOLD, *FIRST	Optional
SHORTSCAN	Short scan	*YES, *NO	Optional
SCANEOF	Scan end of file	*YES, *NO	Optional
POLL	Fast poll interval	0-9999, *DEV	Optional
POLLDLY	Fast poll delay	0-9999, *DEV	Optional
POLLDECAY	Fast poll decay	0-255, *DEV	Optional
SLOWPOLL	Slow poll interval	0-99999, *DEV	Optional
DESTHOP	Destination hop	Single values: *NONE Other values (up to 8 repetitions): Element list	Optional
	Element 1: Destination ID	4001-4FFE
	Element 2: Frequency	1, 2, 3, 4, 5, 900, 901, 902, 903, 904, 905, 906, 907, 908, 909, 910, 911
	Element 3: Data rate	*NONE, 1M, 2M
	Element 4: Radio system identifier	000002-FFFFFE, 000002
BCDGRP	Barcode group	Single values: *NONE Other values (up to 6 repetitions): Name	Optional
TEXT	Text 'description'	Character value, *BLANK	Optional
ENBKBDMAP	Enable keyboard remapping	*NO, *YES	Optional
ENBSCNFMT	Enable screen reformatting	*NO, *YES	Optional
DEVPFX	Device name prefix	Simple name, QWLS	Optional

Top

PTC group (PTCGRP)

Specifies the PTC group name to be added. This name is used to identify configuration data related to a group of PTCs bound by the PTCRANGE parameter. The PTC group name is a unique alphanumeric character string with a maximum of 16 characters in length.

Initialization source member (INZMBR)

Specifies the extended wireless controller source file member in which the PTC entry is added. The PTC configuration data is added to this member.

Initialization source file (INZFILE)

Specifies the name of the source physical file that contains the extended wireless controller source file member. If the source physical file does not exist, this command will fail.

The name of the source file can be qualified by one of the following library values:

*LIBL

All libraries in the job's library list are searched until the first match is found.

*CURLIB

The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name

Specify the name of the library to be searched.

The possible values are:

QEWCSRC

The source file name QEWCSRC is used.

source-file-name

Specify the name of the source physical file.

PTC ID range (PTCRANGE)

Specifies the beginning and ending 4-character decimal PTC ID to use for this PTC group. The defined configuration data is downloaded to any PTC detected within this range. A PTC group of a single PTC can be specified by setting the beginning and ending PTC ID to the same value.

The possible Beginning ID values are:

0001

The value 0001 is used as the beginning PTC ID of the PTC group.

begin-ID

Specify the beginning PTC ID of the PTC group. The valid values range from 0001 through 1022.

The possible Ending ID values are:

1022

The value 1022 is used as the ending PTC ID of the PTC group.

end-ID

Specify the ending PTC ID of the PTC group. The valid values range from 0001 through 1022.

Intensity (INTENSITY)

Specifies how the emulation screen on the PTC handles a field with the intensity attribute set.

The possible values are:

*NORMAL

The field is displayed as normal.

*INVERSE

The field is displayed as reverse image.

Status line (STSLINE)

Specifies whether the status line is displayed on the PTC.

The possible values are:

*YES

The status line is displayed.

*NO

The status line is not displayed.

Cursor type (CSRTYPE)

Specifies the type of cursor for use on the PTC.

The possible values are:

*UNDERLINE

The cursor is an underline cursor.

*BLOCK

The cursor is a block cursor.

Inactivity timer (INACTTMR)

Specifies, in seconds, the inactivity timer value for the PTC. The PTC will power down if no activity occurs on the PTC during this time period.

The possible values are:

*DEV

The default device inactivity timer value is used.

inactivity-timer

Specify the inactivity timer value in seconds. The valid range of values is from 0 through 9999.

Backlight timer (BCKLTTMR)

Specifies, in seconds, the backlight inactivity timer value for the PTC. The PTC turns the backlight off if no activity occurs on the PTC during this time period.

The possible values are:

*DEV

The default device backlight inactivity timer value is used.

backlight-timer

Specify the backlight inactivity timer value in seconds. The valid range of values is from 0 through 9999.

Backlight key (BCKLTKEY)

Specifies whether the backlight turns on when a key is pressed on the PTC.

The possible values are:

*ON

The backlight turns on when a key is pressed.

*OFF

The backlight does not turn on when a key is pressed

Bypass exit (BYPASSEXIT)

Specifies whether to bypass exit processing when leaving emulation on the PTC.

The possible values are:

*NO

Exit processing runs.

*YES

Exit processing does not run.

Automatic run (AUTORUN)

Specifies whether emulation software automatically runs on the PTC at system IPL.

The possible values are:

*NO

Emulation software does not automatically run at system IPL.

*YES

Emulation software automatically runs at system IPL.

Printer (PRINTER)

Specifies whether the printer for the PTC is the system printer or a printer that is locally attached to the PTC.

The possible values are:

*SYSTEM

The system printer is used.

*PTC

The printer that is locally attached to the PTC is used.

Wand type (WANDTYPE)

Specifies the type of wand scanner being used.

The possible values are:

*NONE

No wand scanner is used.

*PENCIL

A pencil wand scanner is used.

*LASER

A laser wand scanner is used.

*RS232

The wand scanner is attached on the RS-232 connector on the PTC.

Wand pecking rate (PECKRATE)

Specifies the wand pecking rate, in milliseconds. This value sets the time interval between the wand power on and power off states that is used to detect whether a label is present.

The possible values are:

*DEV

The default device wand pecking rate is used.

peck-rate

Specify the wand peck rate in milliseconds. Valid values are 2, 4, 8, 16, 32, and 48.

Laser read timer (LASERTMR)

Specifies the laser read timer value, in milliseconds. If a good scan has not been performed before the given timer value, then the laser is turned off.

The possible values are:

*DEV

The default device laser read timer value is used.

laser-read-timer

Specify the laser read timer value in milliseconds. Valid values are 1440,2880,4320, and 5760.

Barcode function keys (BCDFKEY)

Specifies whether function keys are entered by bar code labels.

The possible values are:

*NO

Function key entry by bar code is disabled.

*YES

Function key entry by bar code is enabled.

Auto Enter (AUTOENTER)

Specifies whether the PTC Auto Enter function is on or off.

The possible values are:

*OFF

The Auto Enter function is disabled.

*ON

The Auto Enter function is enabled.

Cursor location (CSRLOC)

Specifies when the cursor is moved from one window chunk to another window chunk, if the cursor defaults to the first input field in the chunk or hold its relative position within the window. A chunk is defined as being a portion of the 5250 emulation screen equal to the size of the PTC display.

The possible values are:

*HOLD

Cursor holds its position when moving from one window chunk to another.

*FIRST

Cursor moves to the first active field when moving from one window chunk to another.

Short scan (SHORTSCAN)

Specifies whether a bar code label that does not completely fill an input field is processed as if it has filled that field.

The possible values are:

*YES

Bar code labels that do not fill an input field are processed as if they have filled the field.

*NO

Bar code labels must fill the input field before they are processed.

Scan end of file (SCANEOF)

Specifies whether an erase end of field is done when a bar code label is shorter than the input field.

The possible values are:

*YES

An erase to end of field is done after a bar code scan.

*NO

An erase to end of field is not done after a bar code scan.

Fast poll interval (POLL)

Specifies, in milliseconds, the fast poll interval for the radio module on the PTC.

The possible values are:

*DEV

The default device fast poll interval value is used.

poll-interval

Specify the fast poll interval in milliseconds. The valid range of values is from 0 through 9999.

Fast poll delay (POLLDLY)

Specifies, in milliseconds, the fast poll delay parameter for the PTC radio module.

The possible values are:

*DEV

The default device fast poll delay value is used.

poll-delay

Specify the fast poll delay value in milliseconds. The valid range of values is from 0 through 9999.

Fast poll decay (POLLDECAY)

Specifies the fast poll decay for the PTC radio module. The valid range of values is from 0 through 255.

The possible values are:

*DEV

The default device fast poll decay value is used.

poll-decay

Specify the fast poll decay value. The valid range of values is from 0 through 255.

Slow poll interval (SLOWPOLL)

Specifies, in milliseconds, the slow poll interval for radio module on the PTC.

The possible values are:

*DEV

The default device slow poll interval value is used.

slow-poll

Specify the slow poll interval in milliseconds. The valid range of values is from 0 through 99999.

Destination hop (DESTHOP)

Specifies the alternate destination ID (transport address) that the PTC attempts to connect to at emulation startup time. This is a four-element field and up to 8 destination hops can be specified.

The possible values are:

*NONE

No destination hops are identified.

The possible Destination ID (Tranport Address) values are:

destination ID

Specify the 4-byte hexadecimal destination ID of a wireless controller. The valid range of values is from 4001 through 4FFE.

Specifies which center frequency to use on the radio based on the radio channel set. The radio channel set is determined by the radio country code.

Valid values are from 1 to 5 for PTC's operating in the 2.4 Gigahertz range and 900 to 911 for PTC's operating in the 900 Megahertz range. If a value in the 900 to 911 range is used, the data rate may not be specified (900 Megahertz data rates are fixed by the frequency channel number).

The possible Frequency values for the 2.4 Gigahertz range are:

For channel set 9, there are five center frequencies.

1

A center frequency of 2.412 gigahertz is used.

2

A center frequency of 2.427 gigahertz is used.

3

A center frequency of 2.442 gigahertz is used.

4

A center frequency of 2.457 gigahertz is used.

5

A center frequency of 2.465 gigahertz is used.

For channel set 10, there are five center frequencies. Channel set 10 is used in ETSI (European Telecommunication and Standards Institute) countries.

1

A center frequency of 2.412 gigahertz is used.

2

A center frequency of 2.427 gigahertz is used.

3

A center frequency of 2.442 gigahertz is used.

4

A center frequency of 2.457 gigahertz is used.

5

A center frequency of 2.472 gigahertz is used.

For channel set 11, there is one center frequency.

1

A center frequency of 2.484 gigahertz is used.

For channel set 12, there are three center frequencies.

1

A center frequency of 2.457 gigahertz is used.

2

A center frequency of 2.465 gigahertz is used.

3

A center frequency of 2.472 gigahertz is used.

For channel set 13, there are three center frequencies.

1

A center frequency of 2.411 gigahertz is used.

2

A center frequency of 2.425 gigahertz is used.

3

A center frequency of 2.439 gigahertz is used.

The possible Frequency values for the 900 Megahertz range are: 900, 901, 902, 903, 904, 905, 906, 907, 908, 909, 910, and 911.

The possible Datarate values are:

Specifies the wireless LAN data rate.

2M

A wireless LAN data rate of 2 megabits per second is used.

1M

A wireless LAN data rate of 1 megabit per second is used.

The possible Sys-ID values are:

Specifies the 6-character hexadecimal radio system identifier to be used.

000002

The value 000002 is used.

sys-ID

Specify a system ID to be used. Valid values range from 000002 to FFFFFE in hexadecimal format and the last digit must be even (for example, 0, 2, 4, 6, 8, A, C, E).

Barcode group (BCDGRP)

Specifies the bar code group names used to define the bar code scanning capability of the PTC group. Bar code group names are defined and modified by the ADDEWCBCDE and CHGEWCBCDE commands.

The possible values are:

*NONE

No bar code group names are defined for this PTC group.

bar-code-group

Specify the bar code group name that corresponds to the bar code scanning capabilities required by the PTC. A maximum of 6 can be specified.

Text 'description' (TEXT)

Specifies text that briefly describes the PTC entry.

The possible values are:

*BLANK

Text is not specified.

'description'

Specify no more than 50 characters of text, enclosed in apostrophes.

Enable keyboard remapping (ENBKBDMAP)

Enables or disables Keyboard Mapping function.

NOTE: The Keyboard Mapping function is not supported on the 2668 Feature Number.

The possible values are:

*NO

The Keyboard Mapping function is disabled.

*YES

The Keyboard Mapping function is enabled.

Enable screen reformatting (ENBSCNFMT)

Enables or disables Screen Reformatter function.

NOTE: The Screen Reformatter function is not supported on the 2668 Feature Number.

The possible values are:

*NO

The Screen Reformatter function is disabled.

*YES

The Screen Reformatter function is enabled.

Device name prefix (DEVPFX)

Specifies a PTC Device Name Prefix. The is a 6 character alpha numeric string that can be used to uniquely identify PTC displays. It will be used in the following format: PPPPPPXXXX. PPPPPP is the 6 character prefix and XXXX is the PTC ID Range.

Examples

ADDEWCPTCE   PTCGRP(PTC01)  INZMBR(EWC01)  PTCRANGE(0001 0020)

This command adds the configuration parameters for the PTC for a PTC group named PTC01 for PTCs with addresses from 1 to 20 to the extended wireless controller source file member EWC01 in source physical file QEWCSRC in the library list.

Error messages

None