# POIS signal conditioning
<a name="scte35-pois-conditioning"></a>

You can configure an AWS Elemental MediaLive channel so that your POIS server can perform *signal conditioning* on SCTE 35 messages that are in the content. Each time MediaLive encounters a SCTE 35 message in the content, MediaLive sends the message to the POIS server. The POIS server sends back a response to create a new SCTE 35 message, to replace the original message with different content, to delete the existing message, or to do nothing. 

**Note**  
To implement POIS signal conditioning, your organization must have access to a POIS server. 

**Topics**
+ [Supported version of the specification](scte35-pois-about-spec.md)
+ [About POIS signal conditioning](scte35-pois-about.md)
+ [Setting up for POIS signal conditioning](scte35-pois-setup.md)

# Supported version of the specification
<a name="scte35-pois-about-spec"></a>

MediaLive communicates with a POIS server using the ESAM API. MediaLive follows the following version of the ESAM specification: 

*OpenCable Specifications Alternate Content Real-time Event Signaling and Management API, OC-SP-ESAM-API-I03-131025*

# About POIS signal conditioning
<a name="scte35-pois-about"></a>

You can configure a MediaLive channel so that your POIS server handles SCTE 35 message that are in the content. 

**Note**  
To implement POIS signal conditioning, your organization must have access to a POIS server. 

## Supported conditioning actions
<a name="scte-35-actions"></a>

Each time MediaLive encounters a SCTE 35 message in the content, MediaLive sends the message to the POIS server. The POIS server responds in one of these way: 
+ Replace: It replaces the content of the original SCTE 35 message and sends it to MediaLive. The output will contain only the original SCTE 35 message, but with the new content.
+ Delete: It instructs MediaLive to delete the SCTE 35 message. The output won't contain the original SCTE 35 message.
+ No op: It instructs MediaLive to do nothing. The output will contain the original SCTE 35 message, with the original content.

The SCTE 35 messages that the POIS server returns are completely compliant with the SCTE 35 standard.

## Number of channels and number of POIS servers
<a name="scte35-pois-setup-limits"></a>
+ Each MediaLive channel can communicate with only one POIS server.
+ One POIS server can communicate with multiple MediaLive channels. In this case, the POIS server identifies each channel using a unique combination of a POIS acquisition point identity and a zone identity.

## POIS signal conditioning and standard channels
<a name="scte-35-pois-standard-channels"></a>

If the channel is a standard channel (with two pipelines), then each pipeline sends the SCTE 35 message to the POIS server. The POIS server responds to each request. Each pipeline handles its own response. Typically, the POIS server sends the identical instruction to both pipelines.

# Setting up for POIS signal conditioning
<a name="scte35-pois-setup"></a>

With POIS signal conditioning, the MediaLive channel and the POIS server must be set up with identical information.

## Required information
<a name="scte35-pois-get-ready"></a>

Obtain the following information from the POIS operator:
+ The *POIS server endpoint*. This is the URL of the POIS server that MediaLive will send events to. The URL must be reachable by MediaLive.
+ The *Acquisition point identity* and the *Zone identity* (optional). These two fields ensure that MediaLive and the POIS server have a common identifier for the channel.
+ POIS endpoint credentials, if the POIS server requires credentials.

## Set up the channel
<a name="scte35-pois-setup-procedure"></a>

You must configure the channel with information about the POIS server.

1. Open the MediaLive console at [https://console.aws.amazon.com/medialive/](https://console.aws.amazon.com/medialive/).

1. Display the details for the channel. In the **General settings** section, expand **Avail Configuration**.

1. Complete the fields as follows:
   + **Avail Settings**: **ESAM**
   + **POIS Endpoint**: The URL that you obtained from the POIS operator.
   + **Acquisition Point Identity**: The value that you obtained from the POIS operator.
   + **Zone Identity**: The value that you obtained from the POIS operator.
   + **Ad Avail Offset**: Enter 0 unless the POIS operator tells you to enter a different value. 
   + **POIS Endpoint Credentials** (optional): Complete these fields if your POIS server requires a username and password.