^NS - Change Wired Networking Settings

^NS configures the wired print server: how it obtains an IP address, the address itself, and the connection timeouts and raw port that go with it. The first argument decides whether the rest matter. P (permanent) uses the address given here. B, C, D, G and R each name a protocol that supplies one instead.

Syntax

^NSa,b,c,d,e,f,g,h,i

Support

Recognised, deliberately skippedparsed: none · state: none · rendered: none

Accepted and skipped, because it configures the printer rather than the label. It cannot change the rendered output, and Labelary skips it too.

IP configuration for the wired print server; none of it reaches the label. The guide documents ^NS twice. The ZPL Commands chapter gives a four-argument Ethernet command; the Wireless Commands chapter gives the nine-argument print-server command below. This page documents the nine-argument form, because it is the superset and matches Labelary's naming. The renderer does not parse this command. It reports IGNORED_COMMAND at info severity, which does not reach X-Warnings. Labelary is also silent, so the rendered label is identical in both engines. — not pinned by a test

Labelary renders this command.

Parameters

aIP resolutionrequired · one of a set

How the wired print server obtains its IP address.

Invalid value: not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage: No documented value is exercised by a test (A, B, C, D, G, R, P).

A: All methods
B: BOOTP
C: DHCP and BOOTP
D: DHCP
G: Gleaning only, which the guide advises against when a wireless print server is fitted
R: RARP
P: Permanent. The printer uses the address below as written.

bIP addressrequired · text

The address in xxx.xxx.xxx.xxx form.

Invalid value: not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage

cSubnet maskrequired · text

The mask in xxx.xxx.xxx.xxx form.

Invalid value: not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage

dDefault gatewayrequired · text

The gateway in xxx.xxx.xxx.xxx form.

Invalid value: not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage

eWINS server addressrequired · text

The WINS server in xxx.xxx.xxx.xxx form.

Invalid value: not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage

fConnection timeout checkingrequired · Y or N

Whether the print server times an idle connection out at all.

Invalid value: not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage: No documented value is exercised by a test (Y, N).

Y: Check for timeouts
N: Do not check

gTimeout valuerequired · integer

Seconds of inactivity before the connection drops.

Accepted range: 0 to 9999 seconds
Invalid value: not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage: No test at the minimum, maximum or one step outside the range.

hARP broadcast intervalrequired · integer

Minutes between the broadcasts that refresh the ARP caches of other devices on the segment.

Invalid value: not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states neither a range nor a default.
Test coverage

iBase raw port numberoptional · integer

TCP port the print server listens on for raw ZPL.

Default: 9100
Accepted range: 0 to 99999
Invalid value: not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage: No test at the minimum, maximum or one step outside the range.

Behavior

The guide documents ^NS twice, with different signatures, and the two do not agree. The ZPL Commands chapter gives ^NSa,b,c,d: four arguments, with lower-case IP resolution codes (a, b, c, d, g, r, p). It describes each address argument as "0 to 255". The Wireless Commands chapter gives the nine-argument ^NSa,b,c,d,e,f,g,h,i documented above, with upper-case codes and full dotted-quad addresses. The parameter table on this page follows the nine-argument form. That form is the fuller of the two, and the four-argument form is a prefix of it. The guide does not state which printers implement which, so this page does not either.

The contradiction runs further. The worked example on the nine-argument page is ^NSa,192.168.0.1,255.255.255.0,192.168.0.2, which supplies four arguments and uses the lower-case spelling from the other chapter. Verify the argument count and the case of the resolution code against the printer's firmware.

The guide also warns against G (gleaning only) on a printer with a Wireless Print Server.

None of this reaches a label. The renderer ignores this command and reads no arguments. It reports IGNORED_COMMAND at info severity, which does not reach the X-Warnings header. Labelary is also silent, so the rendered label is identical in both engines.

Example

A DHCP-resolved wired print server with an address, mask and gateway supplied as a fallback. The label prints exactly as it would without the command:

^XA
^NSD,192.168.0.50,255.255.255.0,192.168.0.1
^FO40,60^A0N,50,50^FDWired settings^FS
^XZ

Open in viewer

^WI Change Wireless Network SettingsSets the wireless print server's addressing, timeout and raw port.
^ND Modify Network SettingsChanges the network settings of a print server.
^NC Set Primary Network DeviceNames the network device the printer treats as primary.
^NP Set Primary/Secondary DeviceChooses whether the printer uses its own LAN settings or the print server's at boot.