PTON

The PTON macro converts an IP address in its standard text presentation form to its numeric binary form. On successful completion, PTON returns the converted IP address in the buffer provided.

The following requirements apply to this call:

Authorization:

Supervisor state or problem state, any PSW key.

Dispatchable unit mode:

Task.

Cross memory mode:

PASN = HASN.

Amode:

31-bit or 24-bit.

Note: See "Addressability mode (Amode) considerations" under CALL instruction API environmental restrictions and programming requirements.

ASC mode:

Primary address space control (ASC) mode.

Interrupt status:

Enabled for interrupts.

Locks:

Unlocked.

Control parameters:

All parameters must be addressable by the caller and in the primary address space.


>>-EZASMI--TYPE=PTON--,AF--=--+-'INET'---+---------------------->
                              +-'INET6'--+   
                              +-address--+   
                              +-*indaddr-+   
                              '-(reg)----'   

>--,SRCADDR--=--+-address--+--,SRCLEN--=--+-address--+---------->
                +-*indaddr-+              +-*indaddr-+   
                '-(reg)----'              '-(reg)----'   

>--,DSTADDR--=--+-address--+--,ERRNO--=--+-address--+----------->
                +-*indaddr-+             +-*indaddr-+   
                '-(reg)----'             '-(reg)----'   

>--,RETCODE--=--+-address--+--+-------------------------+------><
                +-*indaddr-+  '-,ERROR--=--+-address--+-'   
                '-(reg)----'               +-*indaddr-+     
                                           '-(reg)----'

Keyword

Description

AF

Input parameter. Specify one of the following:

Value: Description
'INET' or a decimal '2': Indicates the address being converted is an IPv4 address.
'INET6' or a decimal '19': Indicates the address being converted is an IPv6 address.
AF can also indicate a fullword binary number specifying the address family.

SRCADDR

Input parameter. A field containing the standard text presentation form of the IPv4 or IPv6 address being converted. For IPv4 the address must be in dotted-decimal format and for IPv6 the address must be in colon-hex format. The size of the field for an IPv4 address must be 15 bytes and the size for an IPv6 address must be 45 bytes.

SRCLEN

Input parameter. A binary halfword field that must contain the length of the IP address to be converted.

DSTADDR

A field used to receive the numeric binary form of the IPv4 or IPv6 address being converted in network byte order. For an IPv4 address, this field must be a fullword. For an IPv6 address, this field must be 16 bytes.

ERRNO

Output parameter. A fullword binary field. If RETCODE is negative, ERRNO contains a valid error number. Otherwise, ignore the ERRNO field.

See Socket call error return codes for information about ERRNO return codes.

RETCODE

A fullword binary field that returns one of the following values:

Value: Description
0: Successful call.
–1: Check ERRNO for an error code.

ERROR

Input parameter. The location in your program to receive control when the application programming interface (API) processing module cannot be loaded.